### 接口說明
#### 編碼方式
~~~
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 | 詩詞名 |
