### 3.3.5 娛樂推送 #### (1) 功能說明 娛樂推送主要面向微信端。提供百萬娛樂數據資源涵蓋各類風格的趣圖、段子、漫畫以及圖文消息，實現智能關鍵詞推送。在微信端給用戶返回文本、圖片、圖文等娛樂消息 #### (2) 接口說明 **請求方法** * POST **請求地址** * 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": "63815c88-10a3-4441-bb0d-27c50e9d29a4", "intents": [{ "parameters": { "tag1": "段子", "請求": "講個", "service": "entertainment" }, "action": "sys.action.xxhh", "name": "通用笑話點播", "result": { "category": "段子", "article": "今天我終于鼓足了勇氣去跟我的男神表白了，\r\n但是男神看了看我說：“我有女盆友了，不信給你看！”\r\n我心里面特別不是滋味，男神掏出手機對著我，我看著手機黑色屏幕上印出我的模樣欣喜若狂！\r\n只見男神看了下手機，連忙說：“對不起，我忘了開機了！”", "type": "dialog", "id": "329746", "tags": [ "雷人", "囧", "段子" ], "item_list": [{ "category": "段子", "article": "今天我終于鼓足了勇氣去跟我的男神表白了，\r\n但是男神看了看我說：“我有女盆友了，不信給你看！”\r\n我心里面特別不是滋味，男神掏出手機對著我，我看著手機黑色屏幕上印出我的模樣欣喜若狂！\r\n只見男神看了下手機，連忙說：“對不起，我忘了開機了！”", "type": "dialog", "id": "329746", "tags": [ "雷人", "囧", "段子" ] }, { "category": "段子", "article": "在超市門口，看到一送快遞的小哥，\r\n剛把他的摩托車發動，不到3秒就聽“嘭”的一聲他人和車就倒地上了。\r\n只見他默默的爬了起來，掏出鑰匙把車子前輪的鎖打開。", "type": "dialog", "id": "250778", "tags": [ "囧事", "悲催", "糗事", "段子" ] }, { "category": "段子", "article": "最近我們一同事要跳槽，問其原因，這貨來了句“跟咱們公司文化不合”。\r\n我說什么情況？這貨痛苦的解釋到：“TM別提了，我左邊那哥們和我右邊那女的沒事經常摳鼻屎，這還不算，老是到處亂彈，搞的我提心吊膽。我實在受不了了～～”", "type": "dialog", "id": "69811", "tags": [ "囧事", "苦逼", "悲催", "職場", "段子" ] }, { "category": "段子", "article": "今天下午和一群女同事聊天，突然有人說我不是男人。\r\n我火了，我說，你說我不是，我掏出來給你看。\r\n女生都笑了，有一個最牛，說，你掏啊…………\r\n于是我就把身份證掏出來了。", "type": "dialog", "id": "405875", "tags": [ "機智", "二貨", "段子" ] }, { "category": "段子", "article": "我問老媽咱家有什么祖傳的東西，老媽點了點頭。\r\n我開心的問：“是啥呀，值錢不，給我看看。”\r\n老媽笑著說：“你看過的呀。”\r\n看著我疑惑的眼神老媽掏出一面鏡子：“來，看看你家祖傳的丑。”", "type": "dialog", "id": "360648", "tags": [ "雷人", "搞笑", "段子" ] }, { "category": "段子", "article": "女兒：媽媽，給我編小辮兒。\r\n媽媽：你要是男孩就不用這么麻煩了。\r\n女兒：怎么，你是想讓我出去打架？想讓我不寫作業？想被老師叫去學校了？", "type": "dialog", "id": "233784", "tags": [ "機智", "熊孩子", "段子" ] }, { "category": "段子", "article": "今天晚飯后，和二貨老婆聊天中，老婆突然說：你在炫富嗎？\r\n我不解，二貨繼續說道：你牙齒縫里夾了一絲肉！\r\n我！！！！！", "type": "dialog", "id": "460740", "tags": [ "邪惡", "吐槽", "段子" ] }, { "category": "段子", "article": "方才在麥當當吃飯，鄰桌一個看著就傻不啦嘰的男高中生拍桌大喊：\r\n“一個30人的群，我吆喝一嗓子，只有29個搭話的！剩下那個是誰！看不起我嗎？！有種說話啊！”", "type": "dialog", "id": "51725", "tags": [ "囧", "雷人", "2B青年", "二貨", "段子" ] }, { "category": "段子", "article": "昨天坐地鐵，右前方有個帥小哥一直在看我。我先想是不是臉上有什么東西，然后就在懊惱之前吃面條把漂亮的口紅擦沒了，失策！再抬眼帥小哥還在看我，并且唇角勾起了一個陽光溫暖的笑容，我猜他一定是被我的人格魅力震懾住了。\r\n最后下地鐵的時候，我發現我頭頂的電視廣告在放Tom And Jerry。呵。", "type": "dialog", "id": "438967", "tags": [ "雷人", "趣事", "真相", "段子" ] }, { "category": "段子", "article": "上課的時候，發現是同桌大姨媽來了，她的裙子上有一絲血。\r\n我知道她不敢給老師說，于是我狠狠的給了自己鼻子一拳，瞬間血流成河。。\r\n我舉手，老師我流鼻血了我出去洗一下鼻子，出去后直接到商店買了衛生巾。。。。\r\n后來，她成了我老婆！", "type": "dialog", "id": "30703", "tags": [ "霸氣", "碉堡", "老婆", "段子" ] }], "text": "今天我終于鼓足了勇氣去跟我的男神表白了，\r\n但是男神看了看我說：“我有女盆友了，不信給你看！”\r\n我心里面特別不是滋味，男神掏出手機對著我，我看著手機黑色屏幕上印出我的模樣欣喜若狂！\r\n只見男神看了下手機，連忙說：“對不起，我忘了開機了！”\\n還想看，說【繼續】；還可以讓我【來個蛋疼段子】【來個搞笑圖片】哦！" }, "outputs": [{ "type": "wechat.text", "property": { "text": "今天我終于鼓足了勇氣去跟我的男神表白了，\r\n但是男神看了看我說：“我有女盆友了，不信給你看！”\r\n我心里面特別不是滋味，男神掏出手機對著我，我看著手機黑色屏幕上印出我的模樣欣喜若狂！\r\n只見男神看了下手機，連忙說：“對不起，我忘了開機了！”\\n還想看，說【繼續】；還可以讓我【來個機智段子】【來個搞笑圖片】哦！" } }, { "type": "dialog", "property": { "text": "今天我終于鼓足了勇氣去跟我的男神表白了，\r\n但是男神看了看我說：“我有女盆友了，不信給你看！”\r\n我心里面特別不是滋味，男神掏出手機對著我，我看著手機黑色屏幕上印出我的模樣欣喜若狂！\r\n只見男神看了下手機，連忙說：“對不起，我忘了開機了！”\\n還想看，說【繼續】；還可以讓我【來個吃貨段子】【來個搞笑圖片】哦！", "emotion": "worry" } }], "score": "1.0", "scoreColor": "c4", "is_match": 1, "id": "794cdf6c-f311-48a4-b965-14333af882f3" }], "meta_process_milliseconds": 346 } } ``` **請求示例** （返回圖片信息） * 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": "742ef88e-b433-432a-a3bc-584f32019155", "intents": [{ "parameters": { "tag1": "趣圖", "請求": "我想看", "service": "entertainment" }, "action": "sys.action.xxhh", "name": "通用笑話點播", "result": { "category": "趣圖", "tags": [ "找亮點", "動物", "真相", "雷人", "趣圖", "搞笑圖片" ], "image_url": "http://pic.xxhh.com/cons/20151226/312a07ea21a2e459.jpg", "article": "養龜的人都懂～", "type": "image", "id": "415544", "item_list": [{ "category": "趣圖", "tags": [ "找亮點", "動物", "真相", "雷人", "趣圖", "搞笑圖片" ], "image_url": "http://pic.xxhh.com/cons/20151226/312a07ea21a2e459.jpg", "article": "養龜的人都懂～", "type": "image", "id": "415544" }, { "category": "趣圖", "tags": [ "搞笑", "內涵", "邪惡", "趣圖", "搞笑圖片" ], "image_url": "http://pic.xxhh.com/cons/20140626/67f26f27d53036aa.jpg", "article": "果然夠長～", "type": "image", "id": "119434" }, { "category": "趣圖", "tags": [ "碉堡", "霸氣", "高手", "趣圖", "搞笑圖片" ], "image_url": "http://pic.xxhh.com/cons/20140526/4ad2c4d0d598f6b4.jpg", "article": "大叔一看就是練家子！", "type": "image", "id": "91075" }, { "category": "趣圖", "tags": [ "熊孩子", "搞笑", "趣圖", "搞笑圖片" ], "image_url": "http://pic.xxhh.com/cons/20140113/03217e1398970e14.jpg", "article": "這就是傳說中的王八和綠豆看對眼了么？", "type": "image", "id": "59016" }, { "category": "趣圖", "tags": [ "碉堡", "搞笑", "真相", "趣圖", "搞笑圖片" ], "image_url": "http://pic.xxhh.com/cons/20150323/83b8567ad1b0d65f.jpg", "article": "遙控器壞了，天才的老公是這樣調臺的", "type": "image", "id": "324552" }, { "category": "趣圖", "tags": [ "汪星人", "搞笑", "趣圖", "搞笑圖片" ], "image_url": "http://pic.xxhh.com/cons/20140105/45f9592cbd69be17.jpg", "article": "嚴肅點！我站崗呢", "type": "image", "id": "56760" }, { "category": "趣圖", "tags": [ "搞笑", "動物", "吐槽", "趣圖", "搞笑圖片" ], "image_url": "http://pic.xxhh.com/cons/20160606/2a0c0729ebb2e479.jpg", "article": "夏天去游泳的你", "type": "image", "id": "454074" }, { "category": "趣圖", "tags": [ "熊孩子", "小盆友", "搞笑", "趣圖", "搞笑圖片" ], "image_url": "http://pic.xxhh.com/cons/20150209/1fa5fd5402826c9b.jpg", "article": "醬紫就不怕你不跟我玩了", "type": "image", "id": "311205" }, { "category": "趣圖", "tags": [ "二貨", "惡搞", "雷人", "趣圖", "搞笑圖片" ], "image_url": "http://pic.xxhh.com/cons/20150916/f0ac3533a8f974ac.jpg", "article": "喜歡美少女有什么錯", "type": "image", "id": "381772" }, { "category": "趣圖", "tags": [ "2B青年", "惡搞", "趣圖", "搞笑圖片" ], "image_url": "http://pic.xxhh.com/cons/20150216/d2b79e4e40be4055.jpg", "article": "這才是真正的裝逼起飛的節奏", "type": "image", "id": "314436" }], "text": "http://pic.xxhh.com/cons/20151226/312a07ea21a2e459.jpg" }, "outputs": [{ "type": "wechat.image", "property": { "image_url": "http://pic.xxhh.com/cons/20151226/312a07ea21a2e459.jpg" } }, { "type": "wechat.text", "property": { "text": "http://pic.xxhh.com/cons/20151226/312a07ea21a2e459.jpg" } }, { "type": "dialog", "property": { "text": "http://pic.xxhh.com/cons/20151226/312a07ea21a2e459.jpg", "emotion": "calm" } }], "score": "1.0", "scoreColor": "c4", "is_match": 1, "id": "794cdf6c-f311-48a4-b965-14333af882f3" }], "meta_process_milliseconds": 546 } } ``` **請求示例** （返回圖文信息） * 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": "a2a2606b-9bf5-4501-ba44-b102d56225a6", "intents": [{ "parameters": { "tag1": "B格自習室", "請求": "我想看", "service": "entertainment" }, "action": "sys.action.xxhh", "name": "通用笑話點播", "result": { "category": "B格自習室", "image_url": "http://pic.xxhh.com/day/20160114/159c182682343b12.jpg!270", "description": "", "tags": [ "B格自習室", "B格自習室", "父母為了讓你努力學習，都過什么喪盡天良的方法？" ], "url": "http://www.xxhh.com/daily/4537.html", "title": "父母為了讓你努力學習，都過什么喪盡天良的方法？", "type": "news", "id": "4537", "item_list": [{ "category": "B格自習室", "image_url": "http://pic.xxhh.com/day/20160114/159c182682343b12.jpg!270", "description": "", "tags": [ "B格自習室", "B格自習室", "父母為了讓你努力學習，都過什么喪盡天良的方法？" ], "url": "http://www.xxhh.com/daily/4537.html", "title": "父母為了讓你努力學習，都過什么喪盡天良的方法？", "type": "news", "id": "4537" }, { "category": "B格自習室", "image_url": "http://pic.xxhh.com/day/20150728/33280818e968f658.jpg!270", "description": "", "tags": [ "B格自習室", "B格自習室", "你掙的幾個錢都死哪去了？看完才曉得。。。" ], "url": "http://www.xxhh.com/daily/2887.html", "title": "你掙的幾個錢都死哪去了？看完才曉得。。。", "type": "news", "id": "2887" }, { "category": "B格自習室", "image_url": "http://pic.xxhh.com/day/20151212/8ba89c11c3287ae6.jpg!270", "description": "", "tags": [ "B格自習室", "B格自習室", "女生胸部小！男生是怎么想的？" ], "url": "http://www.xxhh.com/daily/4193.html", "title": "女生胸部小！男生是怎么想的？", "type": "news", "id": "4193" }, { "category": "B格自習室", "image_url": "http://pic.xxhh.com/day/20151116/4575c8185eb283a5.jpg!270", "description": "", "tags": [ "B格自習室", "B格自習室", "雞湯喝多了難免會膩，來看看這些！！" ], "url": "http://www.xxhh.com/daily/3909.html", "title": "雞湯喝多了難免會膩，來看看這些！！", "type": "news", "id": "3909" }, { "category": "B格自習室", "image_url": "http://pic.xxhh.com/day/20141201/7d72c65b59629545.jpg!270", "description": "", "tags": [ "B格自習室", "B格自習室", "朋友圈的真相！！人生已經如此艱難，又何必拆穿。" ], "url": "http://www.xxhh.com/daily/588.html", "title": "朋友圈的真相！！人生已經如此艱難，又何必拆穿。", "type": "news", "id": "588" }, { "category": "B格自習室", "image_url": "http://pic.xxhh.com/day/20150211/e8f8299d1aeefd98.jpg!270", "description": "", "tags": [ "B格自習室", "B格自習室", "兄弟，那些綠茶碧池們是怎樣坑害你的？" ], "url": "http://www.xxhh.com/daily/1395.html", "title": "兄弟，那些綠茶碧池們是怎樣坑害你的？", "type": "news", "id": "1395" }, { "category": "B格自習室", "image_url": "http://pic.xxhh.com/day/20150330/832c7328aeba3d9f.jpg!270", "description": "", "tags": [ "B格自習室", "B格自習室", "看看這些明星的子女，就知道什么叫基因強大！" ], "url": "http://www.xxhh.com/daily/1733.html", "title": "看看這些明星的子女，就知道什么叫基因強大！", "type": "news", "id": "1733" }, { "category": "B格自習室", "image_url": "http://pic.xxhh.com/day/20150605/5c579e13d99a95ab.jpg", "description": "", "tags": [ "大濕兄與小濕妹", "B格自習室", "想當年哥也是有媳婦的人，可是萬萬沒想到！" ], "url": "http://www.xxhh.com/daily/2414.html", "title": "想當年哥也是有媳婦的人，可是萬萬沒想到！", "type": "news", "id": "2414" }, { "category": "B格自習室", "image_url": "http://pic.xxhh.com/day/20150706/54e7dff032c9577d.jpg!270", "description": "", "tags": [ "節操回收站", "B格自習室", "【節操回收站】別人都脫光了，你還好意思穿著嗎？" ], "url": "http://www.xxhh.com/daily/2677.html", "title": "【節操回收站】別人都脫光了，你還好意思穿著嗎？", "type": "news", "id": "2677" }, { "category": "B格自習室", "image_url": "http://pic.xxhh.com/day/20150506/d5790cc0b08c2706.jpg", "description": "", "tags": [ "大濕兄與小濕妹", "B格自習室", "愛她，就和她做最浪漫的事！" ], "url": "http://www.xxhh.com/daily/2104.html", "title": "愛她，就和她做最浪漫的事！", "type": "news", "id": "2104" }], "text": "http://pic.xxhh.com/day/20160114/159c182682343b12.jpg!270" }, "outputs": [{ "type": "wechat.news", "list": [{ "title": "父母為了讓你努力學習，都過什么喪盡天良的方法？", "description": "", "pic_url": "http://pic.xxhh.com/day/20160114/159c182682343b12.jpg!270", "url": "http://www.xxhh.com/daily/4537.html" }] }, { "type": "wechat.text", "property": { "text": "http://pic.xxhh.com/day/20160114/159c182682343b12.jpg!270" } }, { "type": "dialog", "property": { "text": "http://pic.xxhh.com/day/20160114/159c182682343b12.jpg!270", "emotion": "calm" } }], "score": "1.0", "scoreColor": "c4", "is_match": 1, "id": "794cdf6c-f311-48a4-b965-14333af882f3" }], "meta_process_milliseconds": 272 } } ``` **詳細參數說明** |名稱 |類型| 說明 |:---|:---|:--- |service| String |服務名稱 |tags|Array|內容標簽 |article|String|內容 |id|String|源網站ID |item_list|Array |內容列表 |image_url|String|圖片鏈接 |type|String|消息類型，包含dialog、image、news 三種類型 |url|String|圖文鏈接 |description|String|圖文摘要 |title|String|圖文標題