一、接口名称：

背单词接口

二、接口介绍：

单词词汇API包括常见考试词表、小学、中学、高中、四级、六级、托福、雅思、BEC商业考试、朗文、牛津、求职、计算机、医学、建筑、化学、植物、数学、动物、体育、文学、美剧、外贸、新概念等几十个种类的常用词汇表，分类分课，共计70余万词汇。包括音标、释义、发音mp3。

三、API接口文档

1、请求地址

url：https://api.shumaidata.com/v10/recite/word

请求方式 method：post

参数：

2、签名算法说明：

服务商分配的appid、当前时间毫秒数timestamp、商户分配的app_security、 三者通过&符号拼接成字符串进行md5加密得到。

 如：appid=xyzxyzxyz，timestamp=1555378976238，app_security=efcefcefcefcefc ;

 拼接后的字符串格式：str = appid的值&amptimestamp的值&app_security的值;

 拼接后的字符串：str = xyzxyzxyz&1555378976238&efcefcefcefcefc ;

 加密后得到sign = md5(str) = 4e7e1974b79f3656aeaf03f1158f5d5d ;

3、正确返回（单词列表）：

{

   "msg": "成功",

   "success": true,

   "code": 200,

   "data": {

       "orderNo": "5g0b4f5df2m2xhfk3f",

       "ret_code": 0, //0成功其它失败

       "list": [

           {

               "name": "pistol", //英语单词

               "symbol": "[ˈpistl]",  //音标

               "sound": "http://app1.showapi.com/iciba/11_2/pistol.mp3",  //

               "desc": "n. 手枪",  //发音mp3

               "course": "2",  // 课程号

               "class_id": "45090", //书本id

               "class_title": "四级必备词汇"   //书本标题

           },

           {

               "name": "basic",

               "symbol": "[ˈbeisik]",

               "sound": "http://app1.showapi.com/iciba/11_2/basic.mp3",

               "desc": "adj. 基本的；基础的；根本的",

               "course": "2",

               "class_id": "45090",

               "class_title": "四级必备词汇"

           }

      ]

   }

}

4、正确返回（词汇课程列表）：

{

   "msg": "成功",

   "success": true,

   "code": 200,

   "data": {

       "orderNo": "woqi2t7p73pcs2k949",  

       "ret_code": 0, //0成功1失败

       "typeList": [

           {

               "title": "大学英语四级",  //分类标题

               "word_num": "5198", //此类下共有单词数

               "course_num": "261", //此类下共有课程数，每课20个单词

               "child_list": [   //下级书本列表

                   {

                       "class_id": "45090",  //书本id

                       "course_num": "226", //书本下单词数

                       "title": "四级必备词汇", //书本名称

                       "word_num": "4509" //此书本下共有多少单词

                   },

                   {

                       "class_id": "83369",

                       "course_num": "35",

                       "title": "四级救命词汇",

                       "word_num": "689"

                   }

               ]

           }

      ]

   }

}

5、错误返回：

{

   "msg": "参数错误",

   "success": false,

   "code": 400,

   "data": { }

}

6、返回字段说明：

7、code错误码说明