文档首页 > > API参考> 应用侧API参考(联通用户专用)> 推送通知> 设备数据变化通知

设备数据变化通知

分享
更新时间: 2020/01/07 GMT+08:00

接口说明

应用服务器在物联网平台订阅了设备数据变化通知后(订阅的通知类型为deviceDataChanged),当设备上报单个服务属性数据时,平台会向应用服务器推送通知消息。

注意事项

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

URI

请求方法

POST

URI

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

传输协议

HTTPS/HTTP

请求参数

参数

必选/可选

类型

位置

描述

notifyType

必选

String

body

通知类型,取值:deviceDataChanged。

requestId

可选

String(1-128)

body

消息的序列号,唯一标识该消息。

deviceId

必选

String

body

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

gatewayId

必选

String

body

网关ID,用于标识一个网关设备。当设备是直连设备时,gatewayId与设备的deviceId一致。当设备是非直连设备时,gatewayId为设备所关联的直连设备(即网关)的deviceId。

service

必选

DeviceServiceData

body

设备的服务数据,具体参见DeviceServiceData结构体

DeviceServiceData结构体说明:

参数

必选/可选

类型

位置

描述

serviceId

必选

String

body

服务ID。

serviceType

必选

String

body

服务的类型。

data

必选

ObjectNode

body

服务数据信息。

eventTime

必选

String

body

事件发生的UTC时间,时间格式:yyyyMMdd'T'HHmmss'Z',如20151212T121212Z。

若需要显示本地时区时间,您需要自己进行时间转换。

响应参数

Status Code: 200 OK

请求示例

POST {callbackUrl}
Content-Type: application/json

{
  "notifyType": "deviceDataChanged",
  "requestId": "*************",
  "deviceId": "********************************",
  "gatewayId": "*************",
  "service": {
    "serviceId": "Brightness",
    "serviceType": "Brightness",
    "data": {
      "brightness": 80
    },
    "eventTime": "20170311T163657Z"
  }
}

正常响应示例

Status Code: 200 OK
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问