订阅平台业务数据

典型场景

第三方应用可在物联网平台订阅设备相关的业务数据，当物联网平台中设备的业务信 息发生变化时（如设备注册、设备数据上报、设备状态变更等），平台会向第三方应 用发送通知消息，通知其具体的变化信息。第三方应用可以调用此接口向物联网平台 订阅不同类型的设备业务变更通知。

接口功能

支持第三方应用向物联网平台订阅设备的业务变更信息，当设备的状态、数据等信息 发生变化时，平台会向第三方应用发送通知消息。

接口描述

def subDeviceBusinessData(self, sdbdInDTO, accessToken)

参数说明

参数 必选/可

选

类型 位置 描述

sdbdInDT

O 必选 SubDeviceB usinessData InDTO

body 见下表

SubDeviceBusinessDataInDTO 的描述。

accessTok

en 必选 String header 填写鉴权接口获取的 accessToken。

SubDeviceBusinessDataInDTO

参数 必选/

可选

类型 位置 描述

ownerFl

ag 可选 String(256

) query callbackUrl的所有者标识。

● ownerflag为“false”时，表示 callbackUrl的owner是授权应用。

● ownerflag为“true”时，表示 callbackUrl的owner为被授权应用。

appId 可选 String(256

) body 设备所属的appId。

notifyTy

pe 必选 String body 通知类型，第三方应用可以根据通知类 型接收物联网平台推送的对应通知消 息。

● bindDevice（绑定设备，订阅后推 送绑定设备通知）

● deviceAdded（添加新设备，订阅后 推送注册设备通知）

● deviceInfoChanged（设备信息变 化，订阅后推送设备信息变化通 知）

● deviceDataChanged（设备数据变 化，订阅后推送设备数据变化通 知）

● deviceDatasChanged（设备数据批 量变化，订阅后推送批量设备数据 变化通知）

● deviceCapabilitiesChanged（设备 服务能力变化，订阅后推送设备服 务能力变化通知）

● deviceCapabilitiesAdded（设备服 务能力增加，订阅后推送设备服务 能力增加通知）

● deviceCapabilitiesDeleted（设备服 务能力删除，订阅后推送设备服务 能力删除通知）

● deviceDeleted（删除设备，订阅后 推送删除设备通知）

● messageConfirm（消息确认，订阅 后推送设备消息确认通知）

● commandRsp（命令响应，订阅后 推送设备命令响应通知）

● deviceDesiredPropertiesModifyStat usChanged（设备影子状态变更，

订阅后推送设备影子状态变更通 知）

参数 必选/

可选

类型 位置 描述

callback

Url 必选 String(102

4) body 订阅的回调地址，用于接收对应类型的 通知消息。

必须使用HTTPS信道回调地址，同时回 调地址中必须指定回调地址的端口。例 如：https://XXX.XXX.XXX.XXX:443/

callbackurltest

说明HTTP信道只可用于调测。

channel 可选 String(32) Body 传输通道，若是MQTT客户端订阅，则 取值为MQTT，其他情况为HTTP。

响应参数

SubscriptionDTO

参数 类型 描述

subscriptionId String 订阅ID号，用于标识一个订阅。

notifyType String 通知的类型。

callbackUrl String 订阅的回调地址。

错误码

Http状态 码

错误码 错误描述 说明

400 100222 The request

callbackurl is illegal. 回调地址非法。

处理建议：请检查请求体中的回 调地址是否有误。

403 100217 The application hasn't been authorized.

应用未被授权。

处理建议：若非应用授权场景，

请确认请求参数中的appId为 空。

403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流 控值（默认值是100次/60s）。

处理建议：联系物联网平台维护 人员调大流控阈值或者控制接口 的调用频率。

Http状态 码

错误码 错误描述 说明

403 1010005 Invalid access token

or appId. 错误的token信息。

处理建议：请检查接口请求中所 携带的accessToken是否有误。

409 100227 The resource is

conflicted. 资源冲突，通知类型已经被订 阅。

处理建议：请检查要订阅的通知 类型是否已被订阅。