### 3.3.3 幸运签 #### （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=想看看我的爱情运 ```json { "code": 0, "msg": "ok", "result": { "_text": "想看看我的爱情运", "msg_id": "4407fda1-8eb5-4753-ab86-49d01fdbd0aa", "intents": [ { "parameters": { "标签云": "你可以说:学习运,事业运,健康运,财运", "service": "ruyifortune" }, "name": "感情运", "result": { "text": "如意幸运签显示，近期你的恋爱运不错。单身的人可能进入一段暧昧关系；有伴的人，伴侣关系更为稳定，浪漫的恋情，能软化你的固执，驱散你悲观的情绪。", "type": "dialog" }, "outputs": [ { "type": "wechat.text", "property": { "text": "如意幸运签显示，近期单身的你会遇到很喜欢的对象，建议积极争取，有伴的你会体验到爱的唠叨。" } }, { "type": "dialog", "property": { "text": "如意幸运签显示，近期单身的你在恋情上容易相信一些一些不靠谱的承诺，建议留心观察，有伴的你近期双方都很享受互捧的过程。", "emotion": "sad" } } ], "score": "1.0", "scoreColor": "c4", "is_match": 1, "skill_id": "b3228c33-9098-41e1-993f-e3304aab0b56", "id": "e1ddb8f9-4bd4-4a31-ac53-bcb0cf3eecdd", "action": "dialog" } ], "meta_process_milliseconds": 237 } } ``` **详细参数说明** | 名称 | 类型 | 说明 | | :--- | :--- | :--- | | 标签云 | String | 除用户问的运势类型之外，其他运势类型标签 | | service | String | 服务名称 |