### 3.1.5 兒童閑聊 #### （1） 功能說明 基礎對話，主要針對兒童 #### （2） 接口說明 **請求方法** * POST **請求地址** * 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": "ffb136c1-7245-4f43-8077-2e1b7fabb4a2", "intents": [{ "parameters": { "any": "爸爸工作好", "service": "chat_common" }, "action": "1", "name": "生活_辛苦了", "result": { "text": "混口飯吃容易嗎", "type": "dialog" }, "outputs": [{ "type": "wechat.text", "property": { "text": "為人民服務！" } }, { "type": "dialog", "property": { "text": "不客氣不客氣..", "emotion": "negative" } }], "score": "0.9997417303956141", "scoreColor": "c4", "is_match": 1, "id": "d6a7074a-1c2a-459c-8fb0-b308266ff2aa" }], "meta_process_milliseconds": 536 } } ``` **詳細參數說明** |名稱 |類型| 說明 |:---|:---|:--- |service| String |服務名稱 |text|String |返回文本內容