### 3.4.2 計算器 #### （1）功能說明 支持加減乘除混合運算、模運算、分數、小數、π、根號、冪運算等復雜運算,返回計算結果。 #### （2） 接口說明 **請求方法** * POST **請求地址** * http://api.ruyi.ai/v1/message **請求參數說明** |參數名 |參數類型 | 是否必須 |參數說明 | :-----| :---| :---:|:----- |q |String| 是| 自然語言表達，例如“1+1等于多少”,"π是多少"等 |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）請求示例 **請求范例** _π是多少_ _四乘五減三然后乘二_ _一加三再乘五減六_ _根號9等于_ _負六的平方_ _十萬分之一加萬分之一_ _圓周率是多少_ _2除以0_ _2 的1萬次方_ **請求示例** * http://api.ruyi.ai/ruyi-api/v1/message?app_key=APP_KEY&user_id=user0&q=1加1等于幾 返回結果 ```json { "code": 0, "msg": "ok", "result": { "_text": "1加1等于幾", "msg_id": "1f86c462-4d6a-4e96-8400-3a5471c6d524", "intents": [ { "parameters": { "value": "1+1=2", "service": "calculator", "result": "等于幾" }, "action": "calculate", "name": "計算器（識別表達式直接返回結果）", "result": { "text": "我使勁算，用力算，算出來啦，等于2", "type": "dialog" }, "outputs": [ { "type": "wechat.text", "property": { "text": "動動腦，想一想，算出來等于2" } }, { "type": "dialog", "property": { "text": "數一數，算一算，答案出來啦，就是2", "emotion": "calm" } } ], "score": "1.0", "scoreColor": "c4", "is_match": 1, "id": "a28b7dbf-32ed-490a-9f98-7fd3d7965dc1" } ], "meta_process_milliseconds": 46 } } ``` **詳細參數說明** |名稱|類型|說明| |:---|:---|:--- |service | String |服務名稱 |value|String |表達式和結果 |text|String|返回文本