有道云官方文档
有道云翻译API简介:http://ai.youdao.com/docs/doc-trans-api.s#p01
有道云C#Demo : http://ai.youdao.com/docs/doc-trans-api.s#p08
查询单词信息
在有道云的Demo中,已经很完整的给出了相应的代码~
但是针对是的英-汉等翻译,如何只查询单个单词的详细信息,包含单词的翻译/音标/释义等?例如下图示例信息:
下面修改后封装的查询单词详细信息服务(仅供参考):
/// <summary>
/// 有道词典API
/// </summary>
internal class YouDaoApiService
{
const string AppKey = "131b76a4ee1ecd13";//AppKey和AppSecret是本人@Winter申请的账号,仅供测试使用
const string LangEn = "en";
const string AppSecret = "KX9hLrgSMhfKkvIqS6nhwtwMcRymJqEA"; public static async Task<YouDaoTranslationResponse> GetTranslatioAsync(string queryText, string from = LangEn, string to = LangEn)
{
var requestUrl = GetRequestUrl(queryText, from, to); WebRequest translationWebRequest = WebRequest.Create(requestUrl); var response = await translationWebRequest.GetResponseAsync(); using (Stream stream = response.GetResponseStream())
{
using (StreamReader reader = new StreamReader(stream ?? throw new InvalidOperationException("有道Api查询出错!"), Encoding.GetEncoding("utf-8")))
{
string result = reader.ReadToEnd();
var youDaoTranslationResponse = JsonConvert.DeserializeObject<YouDaoTranslationResponse>(result); return youDaoTranslationResponse;
}
}
} private static string GetRequestUrl(string queryText, string from, string to)
{
string salt = DateTime.Now.Millisecond.ToString(); MD5 md5 = new MD5CryptoServiceProvider();
string md5Str = AppKey + queryText + salt + AppSecret;
byte[] output = md5.ComputeHash(Encoding.UTF8.GetBytes(md5Str));
string sign = BitConverter.ToString(output).Replace("-", ""); var requestUrl = string.Format(
"http://openapi.youdao.com/api?appKey={0}&q={1}&from={2}&to={3}&sign={4}&salt={5}",
AppKey,
HttpUtility.UrlDecode(queryText, System.Text.Encoding.GetEncoding("UTF-8")),
from, to, sign, salt); return requestUrl;
}
}
注:值得一提的是,查询单词信息,en->en路径有道提供的数据不完整,会返回301错误码。联系有道开发后,提供的方案是auto->zhs。
序列化解析的数据类:
[DataContract]
public class YouDaoTranslationResponse
{
[DataMember(Name = "errorCode")]
public string ErrorCode { get; set; } [DataMember(Name = "query")]
public string QueryText { get; set; } [DataMember(Name = "speakUrl")]
public string InputSpeakUrl { get; set; } [DataMember(Name = "tSpeakUrl")]
public string TranslationSpeakUrl { get; set; } /// <summary>
/// 首选翻译
/// </summary>
[DataMember(Name = "translation")]
public List<string> FirstTranslation { get; set; } /// <summary>
/// 基本释义
/// </summary>
[DataMember(Name = "basic")]
public TranslationBasicData BasicTranslation { get; set; } ///// <summary>
///// 网络释义,该结果不一定存在,暂时不使用
///// </summary>
//[DataMember(Name = "web")]
//public TranslationWebData WebTranslation { get; set; }
} /// <summary>
/// 基本释义
/// </summary>
[DataContract]
public class TranslationBasicData
{
[DataMember(Name = "phonetic")]
public string Phonetic { get; set; } /// <summary>
/// 英式发音
/// </summary>
[DataMember(Name = "uk-phonetic")]
public string UkPhonetic { get; set; } /// <summary>
/// 美式发音
/// </summary>
[DataMember(Name = "us-phonetic")]
public string UsPhonetic { get; set; } /// <summary>
/// 翻译
/// </summary>
[DataMember(Name = "explains")]
public List<string> Explains { get; set; }
} /// <summary>
/// 网络释义
/// </summary>
[DataContract]
public class TranslationWebData
{
[DataMember(Name = "key")]
public string Key { get; set; } [DataMember(Name = "value")]
public List<string> Explains { get; set; }
}