五分鐘健身 · ruyi.ai開發者文檔

### 3.8.1 五分鐘健身訓練 #### （1）功能說明 5分鐘健身訓練是以身體大肌群的訓練為核心，包括平板支撐、深蹲、俯臥撐和仰臥起坐四個動作，每次訓練時長5分鐘，訓練與休息交替進行，用戶可根據自身條件選擇不同訓練項目和訓練強度，每種強度對應不同的時間安排，獲得的健身效果也有所不同，強度越大效果會越好。每天堅持5分鐘，能夠幫你提高身體基礎代謝率，達到塑型減肥的目的，同時還能增強身體免疫力，提高整體素質！ #### （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 { "_text": "開始五分鐘訓練", "msg_id": "31c177a6-d2c0-40c6-bd70-d99570308de5", "intents": [ { "parameters": {}, "name": "喚醒", "outputs": [ { "type": "wechat.music", "property": { "name": "軌道1_開始訓練_請選擇運動項目_1.mp3", "description": null, "music_url": "http://o8naiyefa.bkt.clouddn.com/Fpb08XJXFpcDEPIqEcBz7B5eFQyx/軌道1_開始訓練_請選擇運動項目_1.mp3", "title": "軌道1_開始訓練_請選擇運動項目_1.mp3" } }, { "type": "voice", "property": { "name": "軌道1_開始訓練_請選擇運動項目_1.mp3", "voice_url": "http://o8naiyefa.bkt.clouddn.com/Fpb08XJXFpcDEPIqEcBz7B5eFQyx/軌道1_開始訓練_請選擇運動項目_1.mp3" } } ], "score": "1.0", "scoreColor": "c4", "is_match": 1, "id": "27a581fa-2c9b-4eb1-bc37-cbba79cbe4ed", "action": "action" } ], "meta_process_milliseconds": 48 } ``` **詳細參數說明** | 名稱 | 類型 | 說明 | | :--- | :--- | :--- | | service | String | 服務名稱 | | keyword | String | 識別關鍵詞 | |music_url|String |微信端音頻鏈接 |voice_url|String |硬件端音頻鏈接