文档首页/ IoT物联网/ API参考/ 应用侧API参考（联通用户专用）/ 订阅管理-V3/ 推送通知/ 设备影子状态变更通知
更新时间：2023-04-13 GMT+08:00
查看PDF
分享

设备影子状态变更通知

接口说明

应用服务器在物联网平台订阅了设备影子状态变更通知后（订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged），当平台中的设备影子向设备同步数据成功或失败时，平台会向应用服务器推送通知消息。

注意事项

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

URI

请求方法

POST

URI

由应用服务器订阅请求消息中的callbackurl决定。

传输协议

HTTPS/HTTP

请求参数

参数

必选/可选

类型

位置

描述

notifyType

必选

String

body

通知类型，取值：deviceDesiredPropertiesModifyStatusChanged。

deviceId

必选

String

body

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

serviceId

必选

String

body

服务ID，用于标识一个服务。

properties

必选

ObjectNode

body

设备影子数据属性

status

必选

String

body

状态，取值DELIVERED/FAILED。

响应参数

Status Code: 200 OK

请求示例

POST {callbackUrl}
Content-Type: application/json

{
  "notifyType": "deviceDesiredPropertiesModifyStatusChanged",
  "deviceId": "******",
  "serviceId": "Device",
  "properties": {
    "Model Number": 1,
    "Serial Number": 2,
    "Firmware Version": "v1.1.0"
  },
  "status": "DELIVERED"
}

正常响应示例

Status Code: 200 OK
父主题： 推送通知

相关文档