Help Center> IoT Device Access> API Reference> 历史API> 应用侧API参考> 订阅管理-V3> 推送通知> 命令状态变化通知
View PDF

命令状态变化通知

接口说明

应用服务器通过物联网平台创建设备命令时，如果设置了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
父主题： 推送通知