### 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|图文标题