### 接口说明
#### 编码方式
~~~
UTF-8
~~~
接口定义
+++
post:http://www.tuling123.com/openapi/api
*string:key=您的apikey#apikey
*info=今天天气怎么样#请求内容
loc=北京市#位置信息，请求跟地理位置相关的内容时使用
userid=12345678#开发者给自己的用户分配的唯一标志
<<<
success
{
"code": 100000,
"text": "嘿嘿，你好我好，大家都好~"
}
<<<
error
{
"code": 40001,
"text": "亲爱的，key不对哦。"
}
+++
### 返回参数
#### 参数说明
~~~
{
"code:"消息标识码",
"text":"文本结果",
"url":"超链接"
}
~~~
#### 消息标识码对照
| code |消息类型 |
| --- | --- |
| 100000 | 文本类 |
| 200000 | 链接类|
| 302000 | 新闻类 |
| 308000 | 菜谱类 |
| 313000 | 儿歌类 |
| 314000 | 诗词类 |
#### 异常码对照
| code |异常信息 |
| --- | --- |
| 40001 | 参数key错误 |
| 40002 | 请求内容info为空 |
| 40004 | 当天请求次数已使用完 |
| 40007 | 数据格式异常 |
#### 消息示例
**新闻资讯**
>[info] 请求参数
~~~
{
"key":"apikey",
"info":"我想看新闻"
}
~~~
>[success] 返回参数
~~~
{
"code": 302000,
"text": "亲，已帮您找到相关新闻",
"list": [
{
"article": "外媒:1名中国人被IS割掉耳朵",
"source": "新浪新闻",
"icon": "http://k.sinaimg.cn/n/news/transform/20161101/GtPb-fxxfyev8929114.jpg/w120h90l50t1986.jpg",
"detailurl": "http://news.sina.cn/2016-11-01/detail-ifxxfuff7441457.d.html?vt=4&pos=3"
},
{
"article": "盘点直播间里的奇葩事件",
"source": "新浪新闻",
"icon": "http://k.sinaimg.cn/n/news/transform/20161101/jbMs-fxxfyez2463469.png/w120h90l50t1152.jpg",
"detailurl": "http://fun.sina.cn/?vt=4&pos=3"
}
]
}
~~~
>字段说明
| 字段 | 说明 |
| --- | --- |
| code | 新闻类标识码 |
| text | 提示语 |
| list | 信息列表 |
| article | 新闻标题 |
| source | 新闻来源 |
| icon | 新闻图片 |
| detailurl | 新闻详情链接 |
**列车查询**
>[info] 请求参数
~~~
{
"key":"apikey",
"info":"北京到拉萨的火车"
}
~~~
>[success] 返回参数
~~~
{
"code": 200000,
"text": "亲，已帮你找到列车信息",
"url": "http://touch.qunar.com/h5/train/trainList..."
}
~~~
>字段说明
| 字段 | 说明 |
| --- | --- |
| code | 链接类标识码 |
| text | 提示语 |
| url | 链接地址 |
**航班查询**
>[info] 请求参数
~~~
{
"key":"apikey",
"info":"明天北京到拉萨的飞机"
}
~~~
>[success] 返回参数
~~~
{
"code": 200000,
"text": "亲，已帮你找到航班信息",
"url": "http://touch.qunar.com/h5/flight/flightlist..."
}
~~~
>字段说明
| 字段 | 说明 |
| --- | --- |
| code | 链接类标识码 |
| text | 提示语 |
| url | 链接地址 |
**菜谱**
>[info] 请求参数
~~~
{
"key":"apikey",
"info":"鱼香肉丝怎么做"
}
~~~
>[success] 返回参数
~~~
{
"code": 308000,
"text": "亲，已帮您找到菜谱信息",
"list": [
{
"name": "鱼香肉丝",
"icon": "",
"info": "瘦肉、黑木耳、胡萝卜、靑椒、豆瓣酱，葱姜蒜、白糖，香醋，料酒",
"detailurl": "http://m.xiachufang.com/recipe/100352761/?ref=tuling"
},
{
"name": "鱼香肉丝",
"icon": "",
"info": "猪瘦肉、莴笋丝、水发木耳、葱花、姜米、蒜米、泡红辣椒",
"detailurl": "http://m.xiachufang.com/recipe/100218709/?ref=tuling"
},
{
"name": "鱼香肉丝",
"icon": "",
"info": "瘦肉、木耳，青椒，胡萝卜、葱，姜，蒜、郫县豆瓣酱",
"detailurl": "http://m.xiachufang.com/recipe/100489447/?ref=tuling"
}
]
}
~~~
>字段说明
| 字段 | 说明 |
| --- | --- |
| code | 菜谱类标识码 |
| text | 提示语 |
| name | 菜名 |
| info | 菜谱信息 |
| detailurl | 详情链接 |
| icon | 信息图标 |
**儿歌**
>[info] 请求参数
~~~
{
"key":"apikey",
"info":"给我唱一首葫芦娃",
"userid":"通过接口获取，必填"
}
~~~
>[success] 返回参数
~~~
{
"code": 313000,
"text": "开始播放音乐。",
"function": {
"song": "葫芦娃",
"singer": "小伴龙"
}
}
~~~
>字段说明
| 字段 | 说明 |
| --- | --- |
| code | 儿歌类标识码 |
| text | 提示语 |
| song | 歌曲名 |
| singer | 歌手 |
**诗词**
>[info] 请求参数
~~~
{
"key":"apikey",
"info":"背一首李白的望庐山瀑布",
"userid":"通过接口获取，必填"
}
~~~
>[success] 返回参数
~~~
{
"code": 314000,
"text": "开始朗读诗词。",
"function": {
"author": "李白",
"name": "望庐山瀑布"
}
}
~~~
>字段说明
| 字段 | 说明 |
| --- | --- |
| code | 诗词类标识码 |
| text | 提示语 |
| author | 作者 |
| name | 诗词名 |
