### 3.4.12 格言 #### （1）功能說明 查詢名人名言，可通過名言中的關鍵詞或者名人的名字來查詢，如“我要查關鍵詞是天才的名言”、“來個魯迅的名言”。名人范圍為90年代前的名人。支持多輪查詢，如“再來一個”，不支持英文查詢&類別查詢（如“勵志名言”、“高考名言”）。 #### （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: "4166d1f5-18dc-4316-bd63-12e9a9ccca3f", intents: [ { parameters: { key: "70617dd808f24244a91b3e2c1a25244f", keyword: "魯迅", any: "", 名言: "名言" }, action: "test", name: "名人和關鍵詞-共用", result: { code: 200, response: { total: 165, result: [ { famous_name: "魯迅", famous_saying: "愛看書的青年，大可以看看本分以外的書，即課外書……譬如學理科的，偏看看文學書，學文學的，偏看看科學書，看看別人在那里研究的，究竟是怎么一回事。這樣子，對于別人，別事，可以更深的了解。" }, { famous_name: "魯迅", famous_saying: "奢侈和淫靡只是一種社會腐化的現像，決不是原因" }, { famous_name: "魯迅", famous_saying: "人必須生活著，愛才有所附麗。" }, { famous_name: "魯迅", famous_saying: "“不恥最后”。即使慢，馳而不息，縱令落后，縱令失敗，但一定可以達到他所向的目標。" }, { famous_name: "魯迅", famous_saying: "養成他們有耐勞作的體力，純潔高尚的道德，廣博自由能容納新潮流的精神，也就是能在世界新潮流中游泳，不被淹沒的力量。" }, { famous_name: "魯迅", famous_saying: "惟有民魂是值得寶貴的，惟有它發揚起來，中國才真有進步。" }, { famous_name: "魯迅", famous_saying: "與其找糊涂導師，倒不如自己走，可以省卻尋覓的功夫，橫豎他也什么都不知道。" }, { famous_name: "魯迅", famous_saying: "在人生的路上，將血一滴一滴地滴過去，以飼別人，雖自覺漸漸瘦弱，也以為快樂。" }, { famous_name: "魯迅", famous_saying: "凡事以理想為因，實行為果。" }, { famous_name: "魯迅", famous_saying: "我想，普遍、永久、完全，這三件寶貝，自然是了不得的，不過也是作家的棺材釘，會將他釘死" }, { famous_name: "魯迅", famous_saying: "苛求君子，寬縱小人，自以為明察秋毫，而實則反助小人張目。" }, { famous_name: "魯迅", famous_saying: "哪里有天才，我是把別人喝咖啡的工夫都用在了工作上了。" }, { famous_name: "魯迅", famous_saying: "如果痛苦換來的是結識真理、堅持真理，就應自覺的欣然承受，那時，也只有那時，痛苦穿掘著靈魂的深處，使人受了精神底苦刑而得到創傷，又即從這得傷和養傷和愈合中，得到苦的滌除，而上了蘇生的路。" }, { famous_name: "魯迅", famous_saying: "以過去和現在的鐵鑄一般的事實來測將來，洞若觀火！" }, { famous_name: "魯迅", famous_saying: "養成他們有耐勞作的體力，純潔高尚的道德，廣博自由能容納新潮流的精神，也就是能在世界新潮流中游泳，不被淹沒的力量" }, { famous_name: "魯迅", famous_saying: "昔者初民，見天地萬物，變異不常，其諸現象，又出于人力所能以上，則自造眾說以解釋之；凡所解釋，今謂之神話" }, { famous_name: "魯迅", famous_saying: "一碗酸辣湯，耳聞口講的，總不如親自呷一口的明白。" }, { famous_name: "魯迅", famous_saying: "無論什么事，如果不斷收集材料，積之十年，總可成一學者。" }, { famous_name: "魯迅", famous_saying: "我的雜文，所寫的常是一鼻、一嘴、一毛，但結合起來，已幾乎是一形象的全體" }, { famous_name: "魯迅", famous_saying: "文藝是國民精神所發的火光，同時也是引導國民精神的前途的燈火" } ], error_code: 0, reason: "Succes" }, text: "魯迅——【哪里有天才，我是把別人喝咖啡的工夫都用在了工作上了。】", type: "dialog" }, outputs: [ { type: "wechat.text", property: { text: "魯迅——【無論什么事，如果不斷收集材料，積之十年，總可成一學者。】" } }, { type: "dialog", property: { text: "魯迅——【如果痛苦換來的是結識真理、堅持真理，就應自覺的欣然承受，那時，也只有那時，痛苦穿掘著靈魂的深處，使人受了精神底苦刑而得到創傷，又即從這得傷和養傷和愈合中，得到苦的滌除，而上了蘇生的路。】", emotion: "calm" } } ], score: "1.0", scoreColor: "c4", is_match: 1, id: "33c5d104-df52-41b3-9c85-aab9866449fe" } ], meta_process_milliseconds: 575 } } ``` **詳細參數說明** | 名稱 | 類型 | 說明 | | :--- | :--- | :--- | | service | String | 服務名稱 | | keyword | String | 識別關鍵詞 |