### 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 | 服務名稱 |