更新时间:2022-02-24 GMT+08:00

命令状态变化通知

典型场景

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

接口功能

支持物联网平台在命令状态发生变化时向应用服务器推送通知消息。

注意事项

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

接口原型

请求方法

POST

请求地址

由应用服务器下发命令请求消息中的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

请求示例

Method: POST
request:
Header:
Content-Type: application/json
Body:
{
  "deviceId": "92d3f8da-200a-4143-8d0d-591a7e11de6c",
  "commandId": "108a9c71462a48e09426e06e844d47ba",
  "result": {
    "resultCode": "SENT",
    "resultDetail": null
  }
}

响应示例

response:
Status Code: 200 OK