更新时间:2022-02-24 GMT+08:00
命令状态变化通知
典型场景
应用服务器通过物联网平台创建设备命令时,如果设置了callbackurl回调地址,当命令状态变化时(执行失败,执行成功,超时,发送,已送达),平台会向应用服务器推送通知消息。
接口功能
支持物联网平台在命令状态发生变化时向应用服务器推送通知消息。
注意事项
应用收到推送消息,请务必返回响应码。
接口原型
请求方法 |
POST |
---|---|
请求地址 |
由应用服务器下发命令请求消息中的callbackurl决定。 |
传输协议 |
HTTPS/HTTP |
请求参数
参数 |
必选/可选 |
类型 |
位置 |
描述 |
---|---|---|---|---|
deviceId |
必选 |
String |
body |
设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 |
commandId |
必选 |
string |
body |
设备命令ID,用于唯一标识一条命令,在下发设备命令时由物联网平台分配获得。 |
result |
必选 |
CommandResultForDevice |
body |
命令状态信息,具体参见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
父主题: 推送通知