设备动作响应上报
更新时间：2022-05-23 01:43:10
本文介绍设备动作响应上报的 API。
接口描述
设备对控制设备的指令的响应。如果设备收到控制指令没有响应，则认为下发的控制指令执行失败。
接口地址
POST: /v1.0/iot-03/3rdcloud/devices/{device_id}/action-resp/report
请求参数
| 参数名 | 类型 | 参数位置 | 是否必填 | 说明 |
|---|---|---|---|---|
| device_id | String | uri | true | 涂鸦设备 ID |
body 说明
| 参数名 | 类型 | 参数位置 | 是否必填 | 说明 |
|---|---|---|---|---|
| msg_id | String | body | true | 下发动作指令的请求 ID，请求和响应消息通过该值建⽴关联关系，⻓度不超过 32 个字符 |
| code | Integer | body | false | 下发动作请求响应 code，默认值为 0。
|
| data | Object | body | false | 设备动作输出参数。 |
data 说明
| 参数名 | 类型 | 参数位置 | 是否必填 | 说明 |
|---|---|---|---|---|
| action_code | String | body | false | 动作 code，功能标识符 |
| output_params | Object | body | false | 动作执⾏的输出参数 |
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| result | Boolean | 响应结果 |
| code | Boolean | 参见错误码，成功为空 |
| msg | String | 请求失败的信息，成功为空 |
| success | Boolean | 请求是否成功。
|
| t | Long | 请求响应的时间戳，长度 13 位 |
请求示例
POST: /v1.0/iot-03/3rdcloud/devices/6cf4171005d11e2ca7****/action-resp/report
{
"msg_id": "ed23rty159292****",
"code": 0,
"data": {
"action_code": "turn_direction",
"output_params": {
"turn_left": 80,
"turn_right": 30
}
}
}
返回示例
{
"result": true,
"t": 1650000809253,
"success": true
}
错误码
参考 错误码。
该内容对您有帮助吗？
是意见反馈该内容对您有帮助吗？
是意见反馈
关注“涂鸦智能”
涂鸦服务尽在掌握
关注“涂鸦开发者”
获取最新涂鸦开发者信息
