### 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 |硬件端音频链接