C# 有道API翻译 查询单词详细信息

原文:C# 有道API翻译 查询单词详细信息

有道云官方文档

有道云翻译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; }
     }