### 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 | 職場運勢 |