### 3.4.15 豆果菜譜
#### (1)功能說明
豆果美食接入完整的豆果API接口,實現菜譜、標簽、場景、食材等多種關鍵詞的搜索,滿足用戶的各類菜譜需求。
#### (2) 接口說明
**請求方法**
* POST
**請求地址**
* [http://api.ruyi.ai/v1/message](http://api.ruyi.ai/v1/message)
**請求參數說明**
| 參數名 | 參數類型 | 是否必須 | 參數說明 |
| :--- | :--- | :---: | :--- |
| q | String | 是 | 自然語言表達,例如“川菜怎么做”|
| app\_key | String | 是 | 應用開發者秘鑰,注冊開發者后臺賬號,建立虛擬助理后獲得 |
| user\_id | String | 是 | 用戶唯一標識,便于支持個性化語義解析。建議開發者使用 UUID 字符,且不同用戶必須用不同的 user\_id,防止意圖串。 |
#### (3) 返回說明
**返回參數說明**
| 名稱 | 類型 | 說明 |
| :--- | :--- | :--- |
| code | Integer | 返回代碼 |
| msg | String | 返回代碼描述 |
| parameters | JSON Object | 解析到的實體以及服務說明 |
| action | String | 服務的接口名稱 |
| name | String | 匹配的意圖名稱 |
| result | JSON Object | 接口返回內容 |
| outputs | Array | 服務輸出結果,微信端使用 type 類型為 wechat 開頭的內容;硬件端收到所有內容,依據需求解析使用 |
**返回代碼說明**
| 返回代碼 | 錯誤類型 | 說明 |
| :--- | :--- | :--- |
| 0/200 | 成功 | 請求成功 |
| 400 | 無效請求 | 某些必需參數缺失或參數值錯誤,詳見msg字段 |
| 401 | 未授權 | 授權失敗,app\_key缺失或錯誤 |
| 403 | 請求被禁止 | 有效請求,但服務拒絕響應,請聯系contact@ruyi.ai |
| 408 | 請求超時 | 請求響應超時,一般響應時間設置為2000ms以內 |
| 429 | 短時間內大量訪問 | 短時間內請求數過多 |
| 500 | 內部錯誤 | 服務處理異常 |
| 503 | 服務不可用 | 服務異常或正在維護 |
#### (4)請求示例
**請求范例**
_打開菜譜_
_川菜怎么做_
_打開第一個_
_第二步怎么做_
_退出_
**請求示例**
* http://api.ruyi.ai/ruyi-api/v1/message?app_key=APP_KEY&user_id=user0&q=川菜怎么做
**返回結果**
```json
{
code: 0,
msg: "ok",
result: {
_text: "川菜怎么做",
msg_id: "22e482f9-1428-457c-8d3c-a120e7b5d456",
intents: [
{
parameters: {
pageNum: "3",
order: "2",
ifMax: "1",
keyword1: "川菜",
page: "1",
any: "",
標簽云: "你可以說:第一個,下一批,翻頁,我想吃蛋包飯,教我做酸湯肥牛面,肉包子怎么蒸",
service: "douguo"
},
action: "豆果菜譜搜索",
name: "P2關鍵詞搜索_菜名",
result: {
code: 200,
response: {
code: "success",
msg: "",
data: {
recipes: [
{
id: 202193,
name: "魚香肉絲",
img: {
s120: "http://i1.douguo.net//upload/caiku/e/f/9/120_ef1b8a39fa93c683e9328ae0d82bf289.jpg",
s200: "http://i1.douguo.net//upload/caiku/e/f/9/200_ef1b8a39fa93c683e9328ae0d82bf289.jpg",
s300: "http://i1.douguo.net//upload/caiku/e/f/9/300_ef1b8a39fa93c683e9328ae0d82bf289.jpg",
s600: "http://i1.douguo.net//upload/caiku/e/f/9/600_ef1b8a39fa93c683e9328ae0d82bf289.jpg",
sbase: "http://i1.douguo.net//upload/caiku/e/f/9/ef1b8a39fa93c683e9328ae0d82bf289.jpg",
sorigin: "http://i1.douguo.net//upload/caiku/e/f/9/yuan_ef1b8a39fa93c683e9328ae0d82bf289.jpg"
},
cookstory: "一直以來,我做菜都會避開那些個經典菜式,覺得經典菜比較大眾,我有喜新厭舊的毛病,這個熟悉我的都知道,比較喜歡做那些有新意的菜。所以自己掌廚好幾年,居然就是沒有嘗試過做這道魚香肉絲。前段時間,小少爺因為在外用餐吃過后特別喜歡,于是回家一個勁的鼓動我做魚香肉絲,我當然得滿足他,于是嘗試著做了一次,哪個曉得,這一做就不可收拾了,首先我自己喜歡死了這個菜,其次灰太狼也喜歡上了,結局就是一周內做了三次這道魚香肉絲,酸、甜、香、鮮,很開胃,味道實在非常的討巧!大力推薦給各位,一個絕對鎮得住場面的家常菜,主婦必學人氣菜式之一。",
ctime: "2012-12-03 10:04:38",
cook_difficulty: "",
anthor: "月亮晶晶",
anthoricon: "http://tx1.douguo.net/upload/photo/4/9/7/70_u99657481.jpg",
major: [
{
title: "豬里脊肉",
note: "250g"
},
{
title: "冬筍",
note: "一小顆"
},
{
title: "胡蘿卜",
note: "小的一根"
},
{
title: "黑木耳",
note: "一小把"
},
{
title: "蔥末",
note: "一茶匙"
},
{
title: "姜末",
note: "一茶匙"
},
{
title: "蒜末",
note: "一茶匙"
},
{
title: "剁椒",
note: "一湯匙"
},
{
title: "水淀粉",
note: "適量"
}
],
minor: [
{
title: "料酒",
note: "一湯匙"
},
{
title: "醋",
note: "兩湯匙"
},
{
title: "生抽",
note: "一湯匙"
},
{
title: "白糖",
note: "一茶匙"
},
{
title: "香麻油",
note: "一茶匙"
},
{
title: "水",
note: "5湯匙"
}
],
clicks: 10788327,
favo_counts: 529762
},
{
id: 699488,
name: "香辣勁爽的水煮肉片超鮮嫩秘法【家樂上菜,家常有味】",
img: {
s120: "http://i1.douguo.net//upload/caiku/6/4/c/120_64b997cc9c9089cae229a56cdc67d47c.jpg",
s200: "http://i1.douguo.net//upload/caiku/6/4/c/200_64b997cc9c9089cae229a56cdc67d47c.jpg",
s300: "http://i1.douguo.net//upload/caiku/6/4/c/300_64b997cc9c9089cae229a56cdc67d47c.jpg",
s600: "http://i1.douguo.net//upload/caiku/6/4/c/600_64b997cc9c9089cae229a56cdc67d47c.jpg",
sbase: "http://i1.douguo.net//upload/caiku/6/4/c/64b997cc9c9089cae229a56cdc67d47c.jpg",
sorigin: "http://i1.douguo.net//upload/caiku/6/4/c/yuan_64b997cc9c9089cae229a56cdc67d47c.jpg"
},
cookstory: "最近入秋了,特別想吃肉,可是又不想吃紅燒肉那樣膩膩的菜~我們那位提議水煮肉片!正好和我意,一想到水煮肉片那辣辣爽爽的感覺,肉片鮮嫩無比的口感,口水都要流下來了,尤其是最后的熱油潑上去發出的“嗤”的一聲,各種香味爆滿~別提多帶勁啦~還有外加提下哈~特別感謝家樂雞粉讓肉片如此鮮嫩,感謝豆果網讓我有這個機會試用,感謝生活讓我有如此多的美食享受~各種愛,各種感恩,各種美味,好幸福吶~~",
ctime: "2013-09-20 17:40:30",
cook_difficulty: "",
anthor: "若雪櫻紫1988",
anthoricon: "http://tx1.douguo.net/upload/photo/a/b/1/70_u7365116144914308021820.jpg",
major: [
{
title: "瘦肉",
note: "300克"
},
{
title: "青菜",
note: "4顆"
},
{
title: "金針菇",
note: "適量"
},
{
title: "香干",
note: "適量"
},
{
title: "冬瓜",
note: "適量"
}
],
minor: [
{
title: "郫縣豆瓣",
note: "3湯匙"
},
{
title: "料酒",
note: "1.5湯匙"
},
{
title: "淀粉",
note: "1.5湯匙"
},
{
title: "家樂雞粉",
note: "1湯匙"
},
{
title: "鹽",
note: "1/2茶匙"
},
{
title: "雞精",
note: "少量"
},
{
title: "干辣椒",
note: "6個"
},
{
title: "花椒",
note: "20粒"
},
{
title: "蔥",
note: "適量"
},
{
title: "生抽",
note: "1茶匙"
},
{
title: "糖",
note: "1茶匙"
},
{
title: "蒜(切末)",
note: "4瓣"
},
{
title: "姜(切末)",
note: "5克"
},
{
title: "胡椒粉",
note: "適量"
},
{
title: "蛋清",
note: "半個"
}
],
clicks: 5645405,
favo_counts: 318371
},
{
id: 183401,
name: "少油的魚香茄子",
img: {
s120: "http://i1.douguo.net//upload/caiku/3/e/8/120_3e47a38b819d9d1a97aee4cea0ce4a88.png",
s200: "http://i1.douguo.net//upload/caiku/3/e/8/200_3e47a38b819d9d1a97aee4cea0ce4a88.png",
s300: "http://i1.douguo.net//upload/caiku/3/e/8/300_3e47a38b819d9d1a97aee4cea0ce4a88.png",
s600: "http://i1.douguo.net//upload/caiku/3/e/8/600_3e47a38b819d9d1a97aee4cea0ce4a88.png",
sbase: "http://i1.douguo.net//upload/caiku/3/e/8/3e47a38b819d9d1a97aee4cea0ce4a88.png",
sorigin: "http://i1.douguo.net//upload/caiku/3/e/8/yuan_3e47a38b819d9d1a97aee4cea0ce4a88.png"
},
cookstory: "小時候極不愛吃茄子,一口都不吃。上高中的時候有一次中午老師拖堂,下課之后食堂只有燒茄子了,無奈只能吃這個,用五花肉燒的茄子拌米飯,都快把我給吃哭了,太好吃了,我怎么長這么大了才發現茄子如此美味呢?從此以后茄子便成為我最愛的蔬菜之一了。",
ctime: "2012-09-19 20:50:36",
cook_difficulty: "配菜(中級)",
anthor: "潘潘貓",
anthoricon: "http://tx1.douguo.net/upload/photo/b/c/6/70_panpanye193958.jpg",
major: [
{
title: "茄子",
note: "一個"
},
{
title: "青椒",
note: "一個"
},
{
title: "蒜末",
note: "適量"
},
{
title: "蔥末",
note: "適量"
},
{
title: "姜末",
note: "適量"
}
],
minor: [
{
title: "郫縣辣醬",
note: "一勺"
},
{
title: "醋",
note: "1勺"
},
{
title: "醬油",
note: "1/2勺"
},
{
title: "糖",
note: "1/2勺"
},
{
title: "淀粉",
note: "1/2勺"
},
{
title: "料酒",
note: "一勺"
}
],
clicks: 9061028,
favo_counts: 314515
}
]
},
page: "1"
},
text: "為您找到“川菜”的相關菜譜",
type: "dialog"
},
outputs: [
{
type: "wechat.text",
property: {
text: "為您找到“川菜”的相關菜譜"
}
},
{
type: "dialog",
property: {
text: "為您找到“川菜”的相關菜譜",
emotion: "calm"
}
}
],
score: "1.0",
scoreColor: "c4",
is_match: 1,
skill_id: "b6c86e82-852f-4e45-b2c0-6a40994f1a75",
id: "e290bfd8-9bd6-4600-9877-0ea37ee59628"
}
],
meta_process_milliseconds: 248
}
}
```
**詳細參數說明**
| 名稱 | 類型 | 說明 |
| :--- | :--- | :--- |
| service | String | 服務名稱 |
| keyword | String | 識別關鍵詞 |
| pageNum | String | 頁數 |
| page | String | 當前頁 |
| order | String | 當前順序 |
| ifMax| String | 是否獲取主料或輔料。1獲取,0不獲取 |
- 1. 海知智能第三方技能插件開放平臺概述
- 2. 快速接入API
- 2.1 硬件接口調用
- 2.2 快速接入微信
- 2.3 API接入常見問題
- 3. 技能插件
- 3.1 基礎能力類
- 頂級過濾器
- 用戶知識圖譜
- 機器人檔案
- 通用閑聊
- 兒童閑聊
- Smart Reply
- 輕量閑聊
- 3.2 語音游戲類
- 成語接龍
- 詞匯樂園
- 詞語接龍
- 鸚鵡學舌
- 動腦猜猜
- 挑戰單詞
- 冒險世界
- 猜猜我是誰
- 阿拉丁學詩詞
- 貓貓托管所
- 漂流瓶
- 詩詞大會
- 國學大會
- 我愛猜歌名
- 我在看著你
- 燈謎猜猜
- 3.3 休閑娛樂類
- 星座運勢
- 悅耳聲音
- 幸運簽
- 調教機器人
- 娛樂推送
- 3.4 生活服務類
- 黃歷
- 計算器
- 古詩詞
- 時間詢問
- 翻譯類技能
- 天氣資訊
- 日程創建
- 日程創建指令
- 鬧鐘
- 食材知識
- 冥想音樂
- 格言
- 每日英語
- 漢語詞典
- 豆果菜譜
- 古文翻譯
- 3.5 音頻點播類
- 喜馬拉雅FM
- 新聞廣播
- 音樂點播
- Smart Music
- 兒童聽聽
- Smart Audio
- 兒童笑話
- 點播控制指令
- 3.6 視頻點播類
- 影視點播
- 3.7 百科知識類
- 人物百科
- 百科問答
- 實時百科
- 3.8 體育健康類
- 五分鐘健身
- 4. 開發者初級教程
- 4.1 開通服務
- 4.2 創建機器人
- 4.3 設置機器人
- 4.4 獲取技能插件
- 4.5 讓機器人學會聊天
- 4.6 導入知識庫
- 4.7 多種問答形式
- 4.8 數據統計
- 4.9 粉絲管理
- 5. 開發者中級教程
- 5.1 詞典運用
- 5.2 意圖處理
- 5.3 暗號使用
- 5.4 事件觸發
- 5.5 優先級
- 5.6 觸發器
- 5.7 快捷鍵
- 5.8 意圖報錯
- 6. 開發者高級教程
- 6.1 handlebars模版語言
- 6.2 JavaScript簡單介紹
- 6.3 JavaScript使用說明
- 6.4 JavaScript使用案例
- 6.5 JavaScript常見問題
- 7. 快速發布技能
- 8. 幫助中心
- 8.1 常見概念
- 8.2 幫助視頻
- 8.3 聯系我們