### 3.3.1 星座运势 #### (1)功能说明 通过十二星座名称来查询十二星座当日、本周、本月和本年的运势,返回给用户多项运势指数。 #### (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=今天狮子座运势](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": "efee79b2-2ff5-4bd7-9955-81c8e439770d", "intents": [{ "parameters": { "date": "1481731200000", "name": "狮子座", "expiration": "today", "type": "today", "service": "astrology" }, "action": "sys.action.constellation/luck", "name": "直接查询——今天运势", "result": { "name": "狮子座", "all": "20%", "color": "紫色", "number": 7, "summary": "今天你难免会有一些挣扎的感觉,特别想要舍弃一些想法,改变自己的日常作息或是工作状态,但却很难作出理性的判断,睡眠质量也可能会下降", "friend": "天蝎座", "date": "2016-12-15", "text": "2016-12-15的今日运程为:\\n整体运势:20%\\n颜色:紫色\\n幸运数字:7\\n 友好星座:天蝎座\\n总结:今天你难免会有一些挣扎的感觉,特别想要舍弃一些想法,改变自己的日常作息或是工作状态,但却很难作出理性的判断,睡眠质量也可能会下降", "type": "dialog" }, "outputs": [{ "type": "wechat.text", "property": { "text": "狮子座 2016-12-15 的运程为:\n整体运势: 20%\n颜色:紫色\n幸运数字:7\n友好星座:天蝎座\n总结:今天你难免会有一些挣扎的感觉,特别想要舍弃一些想法,改变自己的日常作息或是工作状态,但却很难作出理性的判断,睡眠质量也可能会下降" } }, { "type": "dialog", "property": { "text": "狮子座2016-12-15的运程为:整体运势:20%颜色:紫色幸运数字:7友好星座:天蝎座总结:今天你难免会有一些挣扎的感觉,特别想要舍弃一些想法,改变自己的日常作息或是工作状态,但却很难作出理性的判断,睡眠质量也可能会下降", "emotion": "like" } }], "score": "1.0", "scoreColor": "c4", "is_match": 1, "id": "9cd0f394-3e28-44b6-a2ea-2a25ad5b7114" }], "meta_process_milliseconds": 95 } } ``` **请求示例** (本周运势查询) * [http://api.ruyi.ai/ruyi-api/v1/message?app\_key=APP\_KEY&user\_id=user0&q=本周狮子座运势](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": "2bef3ad2-cdbc-42f5-a3ae-a154eec93575", "intents": [{ "parameters": { "name": "狮子座", "expiration": "today", "type": "week", "运势": "运势", "本周": "本周", "constellation": "狮子座", "service": "astrology" }, "action": "sys.action.constellation/luck", "name": "直接查询——本周运势", "result": { "date": "2016年12月11日-2016年12月17日", "name": "狮子座", "health": "健康:小病痛多,尤其是呼吸系统的疾病。 作者:马子晴", "job": "求职:借助团队,搭便车求职比较有利。 ", "love": "恋情:伴侣关系改观,逐渐地,能站在对方的角度,去理解、包容。单身汪,桃花运散去,但是有机会在那些留下来陪伴的人身上发现真爱。 ", "money": "财运:合作生财运气旺,但是要记得做到公平公正。 ", "weekth": 51, "work": "工作:有一种大势已去的感觉,工作上的机会你想尽力去挽回,已经不可能,搭档虽然给力,但也只是在做小修补。 ", "resultcode": "200", "error_code": 0, "text": "2016年12月11日-2016年12月17日的今日运程为:\\n整体运势:\\n颜色:\\n幸运数字:\\n 友好星座:\\n总结:", "type": "dialog" }, "outputs": [{ "type": "wechat.text", "property": { "text": "狮子座本周(2016年12月11日-2016年12月17日)的运势为:\\n健康:小病痛多,尤其是呼吸系统的疾病。 作者:马子晴\\n求职:借助团队,搭便车求职比较有利。 \\n恋情:伴侣关系改观,逐渐地,能站在对方的角度,去理解、包容。单身汪,桃花运散去,但是有机会在那些留下来陪伴的人身上发现真爱。 \\n财运:合作生财运气旺,但是要记得做到公平公正。 \\n51\\n工作:有一种大势已去的感觉,工作上的机会你想尽力去挽回,已经不可能,搭档虽然给力,但也只是在做小修补。 \\n" } }, { "type": "dialog", "property": { "text": "狮子座本周(2016年12月11日-2016年12月17日)的运势为:健康:小病痛多,尤其是呼吸系统的疾病。 作者:马子晴求职:借助团队,搭便车求职比较有利。 恋情:伴侣关系改观,逐渐地,能站在对方的角度,去理解、包容。单身汪,桃花运散去,但是有机会在那些留下来陪伴的人身上发现真爱。 财运:合作生财运气旺,但是要记得做到公平公正。 51工作:有一种大势已去的感觉,工作上的机会你想尽力去挽回,已经不可能,搭档虽然给力,但也只是在做小修补。 ", "emotion": "worry" } }], "score": "1.0", "scoreColor": "c4", "is_match": 1, "id": "f1a66b28-9e87-4b55-ba25-b2dd93a24871" }], "meta_process_milliseconds": 48 } } ``` **请求示例** (本月运势查询) * [http://api.ruyi.ai/ruyi-api/v1/message?app\_key=APP\_KEY&user\_id=user0&q=本月狮子座运势](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": "01608e6d-2295-4018-868b-0ed181c0d916", "intents": [{ "parameters": { "name": "狮子座", "expiration": "today", "type": "month", "运势": "运势", "本月": "本月", "constellation": "狮子座", "service": "astrology" }, "action": "sys.action.constellation/luck", "name": "直接查询——本月运势", "result": { "date": "2016年12月", "name": "狮子座", "all": "月初水星转入工作宫,直达月底,工作占据着你本月的思维,但是现实的运气真的不怎么样。金星上旬就离开工作宫,预示着工作的趣味性在减弱。你会变得很容易厌烦工作,尤其是无休止的连续工作,同时出差也多,总是四处奔波。而上旬和中旬太阳的位置在恋爱宫,正是玩和恋爱机会多的时候,看着别人玩心头痒痒的,自己还要为工作烦心,这是怎么一个惨状!下旬,太阳转宫,工作压力加码,而此时又撞上水逆,误会和意外不断,虽然有搭档帮忙,但改变不了大势。", "happyMagic": "", "health": "一波未平一波又起。这个病好了那个病又来,本月的病根就没有断过,尤其是富贵病和呼吸系统的疾病。小提醒,本月的身体触觉特别敏感,去做个身体检查是及时发现大病的办法。冥王星近年在健康宫位运作,你要多加小心。\r\n", "love": "单身汪的桃花运还是可以的,尤其可以在共事关系中发展情缘。伴侣之间的情感发展就比较复杂了,首先你们特别的在意对方,忍不住要去管束对方,这样做往往会引起反抗、敌对、争吵,同时你也时时刻刻感受到伴侣对你的陪伴和帮忙,真是又爱又恨。\r\n", "money": "加薪的通道会在上旬关闭,要争取时机了。中旬起,合作生财的运气旺,但是也容易引发爆点,所以先小人后君子,时候做好约定很有必要。下旬,对短炒、暴利会很敏感,那可是个坑啊。\r\n", "month": 12, "work": "参考总运势,还要注意两点,一是火星上旬和中旬在合作宫,容易和搭档、团队起冲突,虽然他们很能帮到你,但要想控制对方是不行的。下旬火星入资源宫,对职权漏洞、潜规则这些会很敏感很热衷。小提醒,海王近年也在该宫运行,这些小便宜往往是带有蛊惑性的,不建议沾边。\r\n", "resultcode": "200", "error_code": 0, "type": "undefined" }, "outputs": [{ "type": "wechat.text", "property": { "text": "狮子座本月(2016年12月)的运势为:\\n月初水星转入工作宫,直达月底,工作占据着你本月的思维,但是现实的运气真的不怎么样。金星上旬就离开工作宫,预示着工作的趣味性在减弱。你会变得很容易厌烦工作,尤其是无休止的连续工作,同时出差也多,总是四处奔波。而上旬和中旬太阳的位置在恋爱宫,正是玩和恋爱机会多的时候,看着别人玩心头痒痒的,自己还要为工作烦心,这是怎么一个惨状!下旬,太阳转宫,工作压力加码,而此时又撞上水逆,误会和意外不断,虽然有搭档帮忙,但改变不了大势。\\n一波未平一波又起。这个病好了那个病又来,本月的病根就没有断过,尤其是富贵病和呼吸系统的疾病。小提醒,本月的身体触觉特别敏感,去做个身体检查是及时发现大病的办法。冥王星近年在健康宫位运作,你要多加小心。\r\n\\n单身汪的桃花运还是可以的,尤其可以在共事关系中发展情缘。伴侣之间的情感发展就比较复杂了,首先你们特别的在意对方,忍不住要去管束对方,这样做往往会引起反抗、敌对、争吵,同时你也时时刻刻感受到伴侣对你的陪伴和帮忙,真是又爱又恨。\r\n\\n加薪的通道会在上旬关闭,要争取时机了。中旬起,合作生财的运气旺,但是也容易引发爆点,所以先小人后君子,时候做好约定很有必要。下旬,对短炒、暴利会很敏感,那可是个坑啊。\r\n\\n参考总运势,还要注意两点,一是火星上旬和中旬在合作宫,容易和搭档、团队起冲突,虽然他们很能帮到你,但要想控制对方是不行的。下旬火星入资源宫,对职权漏洞、潜规则这些会很敏感很热衷。小提醒,海王近年也在该宫运行,这些小便宜往往是带有蛊惑性的,不建议沾边。\r\n\\n" } }, { "type": "dialog", "property": { "text": "狮子座本月(2016年12月)的运势为:月初水星转入工作宫,直达月底,工作占据着你本月的思维,但是现实的运气真的不怎么样。金星上旬就离开工作宫,预示着工作的趣味性在减弱。你会变得很容易厌烦工作,尤其是无休止的连续工作,同时出差也多,总是四处奔波。而上旬和中旬太阳的位置在恋爱宫,正是玩和恋爱机会多的时候,看着别人玩心头痒痒的,自己还要为工作烦心,这是怎么一个惨状!下旬,太阳转宫,工作压力加码,而此时又撞上水逆,误会和意外不断,虽然有搭档帮忙,但改变不了大势。一波未平一波又起。这个病好了那个病又来,本月的病根就没有断过,尤其是富贵病和呼吸系统的疾病。小提醒,本月的身体触觉特别敏感,去做个身体检查是及时发现大病的办法。冥王星近年在健康宫位运作,你要多加小心。\r\n单身汪的桃花运还是可以的,尤其可以在共事关系中发展情缘。伴侣之间的情感发展就比较复杂了,首先你们特别的在意对方,忍不住要去管束对方,这样做往往会引起反抗、敌对、争吵,同时你也时时刻刻感受到伴侣对你的陪伴和帮忙,真是又爱又恨。\r\n加薪的通道会在上旬关闭,要争取时机了。中旬起,合作生财的运气旺,但是也容易引发爆点,所以先小人后君子,时候做好约定很有必要。下旬,对短炒、暴利会很敏感,那可是个坑啊。\r\n参考总运势,还要注意两点,一是火星上旬和中旬在合作宫,容易和搭档、团队起冲突,虽然他们很能帮到你,但要想控制对方是不行的。下旬火星入资源宫,对职权漏洞、潜规则这些会很敏感很热衷。小提醒,海王近年也在该宫运行,这些小便宜往往是带有蛊惑性的,不建议沾边。\r\n", "emotion": "worry" } }], "score": "1.0", "scoreColor": "c4", "is_match": 1, "id": "732e7051-9be4-495c-b746-27fe0554f8b4" }], "meta_process_milliseconds": 330 } } ``` **请求示例** (今年运势查询) * [http://api.ruyi.ai/ruyi-api/v1/message?app\_key=APP\_KEY&user\_id=user0&q=今年狮子座运势](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": "0330cd07-0aa8-4524-8d01-80b123594045", "intents": [{ "parameters": { "name": "狮子座", "expiration": "today", "type": "year", "运势": "运势", "今年": "本年", "constellation": "狮子座", "service": "astrology" }, "action": "sys.action.constellation/luck", "name": "直接查询——今年运势", "result": { "date": "2016年", "name": "狮子座", "year": 2016, "resultcode": "200", "error_code": 0, "mima": { "info": "开放的一年", "text": [ "来到2016年,木星落在狮子座的命宫,无论是外在还是内在,狮子都开始变得更加光芒四射,朝着周围散发自己的光和热。整体运势非常不错,帮助狮子座朝着更大的方向迈进。同时,因为天王星的关系,狮子座更加受不了世俗的约束,想要按照自己的意愿取得成就。" ] }, "career": [ "狮子座的工作能力一直是让其他十一星座敬佩的,不过狮子座平时为人方面太过高调,也容易招致心胸狭隘之人的横加阻挠,导致工作难以顺利进行。学业上,天王星和木星有比较不错的相位,帮助狮子座在日常的学习方面有着更加深入的思考,容易因此取得更好的成绩。" ], "love": [ "木星落在狮子座的命宫,虽然爱情方面没有直接的影响,但是随着狮子座受到越来越多人的关注,总会有些个春心萌动的异性会成为狮子座的桃花。所以今年狮子座的感情运势还是不错的。在此之前土星对于感情方面的压抑,让狮子座很是憋了一口气。" ], "health": [ "狮子座在占星学上掌管着人体的心脏和脊椎,正处于事业上升期,一心争名夺利的狮子,很可能因为疏于防范,而给这两个方面留下隐患。越是光鲜亮丽的表面,背后越容易出现大的隐患,在日常工作之余,还是多点锻炼,游泳是一个非常不错的选择。" ], "finance": [ "今年狮子座的财运有着鲜明的起落曲线。上半年为了包装自己,狮子座把全部的重点都放在木星对于命宫的影响上面,不得不说这也是狮子座一直以来想做的事,而这件事必然要大量的经济支出作为支撑。" ], "luckyStone": "红兔毛", "future": [ "" ], "type": "undefined" }, "outputs": [{ "type": "wechat.text", "property": { "text": "狮子座今年(2016年)的运势为:\\n[狮子座的工作能力一直是让其他十一星座敬佩的,不过狮子座平时为人方面太过高调,也容易招致心胸狭隘之人的横加阻挠,导致工作难以顺利进行。学业上,天王星和木星有比较不错的相位,帮助狮子座在日常的学习方面有着更加深入的思考,容易因此取得更好的成绩。]\\n[狮子座在占星学上掌管着人体的心脏和脊椎,正处于事业上升期,一心争名夺利的狮子,很可能因为疏于防范,而给这两个方面留下隐患。越是光鲜亮丽的表面,背后越容易出现大的隐患,在日常工作之余,还是多点锻炼,游泳是一个非常不错的选择。]\\n[木星落在狮子座的命宫,虽然爱情方面没有直接的影响,但是随着狮子座受到越来越多人的关注,总会有些个春心萌动的异性会成为狮子座的桃花。所以今年狮子座的感情运势还是不错的。在此之前土星对于感情方面的压抑,让狮子座很是憋了一口气。]\\n[今年狮子座的财运有着鲜明的起落曲线。上半年为了包装自己,狮子座把全部的重点都放在木星对于命宫的影响上面,不得不说这也是狮子座一直以来想做的事,而这件事必然要大量的经济支出作为支撑。]\\n红兔毛\\n" } }, { "type": "dialog", "property": { "text": "狮子座今年(2016年)的运势为:\n\n\n\n红兔毛", "emotion": "calm" } }], "score": "1.0", "scoreColor": "c4", "is_match": 1, "id": "c29f99a3-96a5-4c8d-a4c2-6ec5d0a45a31" }], "meta_process_milliseconds": 97 } } ``` **详细参数说明** | 名称 | 类型 | 说明 | | :--- | :--- | :--- | | service | String | 服务名称 | | date | String | 识别的时间 | | name | String | 识别的星座名称 | | type | String | 查询的运势类型,包含当日、本周、本月、本年 | | expiration | String | 缓存参数,today 表示当天缓存 | | all | String | 整体运势指数 | | color | String | 幸运色 | | number | String | 幸运数字 | | summary | String | 总体运势 | | friend | String | 友好星座 | | health | String | 健康运势 | | job | String | 求职运势 | | love | String | 爱情运势 | | money | String | 财运 | | weekth | Integer | 本年的第几周 | | work | String | 工作运势 | | month | Integer | 本年的第几月 | | finance | String | 财运 | | luckyStone | String | 幸运物 | | future | String | 未来运势 | | career | String | 职场运势 |