### 3.4.13 每日英語 #### （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: "6ab95749-5667-4a4d-be7a-cbb3da4eb8b1", intents: [ { parameters: { count: "10", showapi_appid: "39740", showapi_sign: "a1f168bb4fc94691aa83da5a8638a1dc", service: "Daily English" }, action: "每日英語", name: "每日英語", result: { code: 200, response: { showapi_res_code: 0, showapi_res_error: "", showapi_res_body: { ret_code: 0, ret_message: "Success", data: [ { english: "The most known person,the warmest partner.", chinese: "最懂的人，最暖的伴。" }, { english: "In our life we are laughing more happily than anybody else.But when the crowd dissipates,we feel much more lonely than anybody else.", chinese: "生活中我們笑得比誰都開心，可是當所有人潮散去的時候，我們比誰都落寂。" }, { english: "Sometimes all I need is someone to hug me tight and refuse to let me go until I feel all better.", chinese: "有時候，只是想有個人抱緊我不放手，直到我的心情真的好起來。" }, { english: "Brief is life, but love is long.", chinese: "生命雖短，愛卻綿長。" }, { english: "Love is like sentence spell always let people willingly addictions", chinese: "愛情像句咒語 總讓人甘心沉迷。" }, { english: "A friend who betray you in the end, is never your friend from the beginning.", chinese: "最終背叛你的朋友，其實一開始就不是你的朋友。" }, { english: "I wouldn't say love, but I said is true.", chinese: "我不會說情話，但我說的都是真心話。" }, { english: "Something you will realize only when you do it,when you make mistakes or when you grow up.", chinese: "有些事，做了才知道。有些事，錯了才知道。有些事，長大了才知道。" }, { english: "Back to the past, return not anymore at the beginning.", chinese: "回得了過去，回不了當初。" }, { english: "Apologizing does not always mean you are wrong & the other person is right. It just means you value your relationship more than your ego.", chinese: "道歉并不總是代表我承認自己錯了，只能說，我在乎我們的關系，比我自身還在乎。" } ] } }, text: "英文語錄來啦！I wouldn't say love, but I said is true.我不會說情話，但我說的都是真心話。你可以試試“再來一個”哦", type: "dialog" }, outputs: [ { type: "wechat.text", property: { text: "英文語錄來啦！Apologizing does not always mean you are wrong & the other person is right. It just means you value your relationship more than your ego.道歉并不總是代表我承認自己錯了，只能說，我在乎我們的關系，比我自身還在乎。你可以試試“再來一個”哦" } }, { type: "dialog", property: { text: "英文語錄來啦！Apologizing does not always mean you are wrong & the other person is right. It just means you value your relationship more than your ego.道歉并不總是代表我承認自己錯了，只能說，我在乎我們的關系，比我自身還在乎。你可以試試“再來一個”哦", emotion: "positive" } } ], score: "1.0", scoreColor: "c4", is_match: 1, id: "4317d377-5bd2-4b81-91a5-d5f240658a40" } ], meta_process_milliseconds: 277 } } ``` **詳細參數說明** | 名稱 | 類型 | 說明 | | :--- | :--- | :--- | | service | String | 服務名稱 |