### 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 | 职场运势 |
- 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 联系我们