设备接入 IoTDA设备接入 IoTDA

更新时间:2021/09/06 GMT+08:00
分享

命令状态变化通知

接口说明

应用服务器通过物联网平台创建设备命令时,如果设置了callbackurl回调地址,当命令状态变化时(执行失败,执行成功,超时,发送,已送达),平台会向应用服务器推送通知消息。

注意事项

应用收到推送消息,请务必返回响应码。

URI

请求方法

POST

URI

由应用服务器下发命令请求消息中的callbackurl决定。

传输协议

HTTPS/HTTP

请求参数

参数

必选/可选

类型

位置

描述

deviceId

必选

String

body

设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。

commandId

必选

string

body

设备命令ID,用于唯一标识一条命令,在下发设备命令时由物联网平台分配获得。

result

必选

CommandResultForDevice

body

命令状态信息,具体参见CommandResultForDevice结构体

CommandResultForDevice结构体说明:

参数

必选/可选

类型

位置

描述

resultCode

必选

String

body

命令状态。

resultDetail

必选

ObjectNode

body

命令结果详细信息。

响应参数

Status Code: 200 OK

请求示例

POST {callbackUrl}
Content-Type: application/json

{
  "deviceId": "92d3f8da-200a-4143-8d0d-591a7e11de6c",
  "commandId": "108a9c71462a48e09426e06e844d47ba",
  "result": {
    "resultCode": "SENT",
    "resultDetail": null
  }
}

正常响应示例

Status Code: 200 OK
分享:

    相关文档

    相关产品