查询单个订阅
典型场景
第三方应用可在物联网平台上创建多个订阅,以订阅不同类型的设备变更通知。第三方应用若需要查看某个订阅的配置信息,可调用此接口进行查询。
接口功能
支持第三方应用在物联网平台根据订阅ID查询指定订阅的配置信息。
接口描述
1
|
def querySingleSubscription(self, subscriptionId, appId, accessToken) |
参数说明
参数 |
必选/可选 |
类型 |
位置 |
描述 |
---|---|---|---|---|
subscriptionId |
必选 |
String |
path |
订阅ID号,通过调用订阅接口返回或者查询订阅接口获得。 |
appId |
可选 |
String |
query |
如果是本应用的设备,此参数值可以填写None,否则填写授权应用的appId。 |
accessToken |
必选 |
String |
header |
填写鉴权接口获取的accessToken。 |
响应参数
SubscriptionDTO
参数 |
类型 |
描述 |
---|---|---|
subscriptionId |
String |
订阅ID号,用于标识一个订阅。 |
notifyType |
String |
通知的类型。 |
callbackUrl |
String |
订阅的回调地址。 |
错误码
Http状态码 |
错误码 |
错误描述 |
说明 |
---|---|---|---|
403 |
1010009 |
app throttle exceed. |
应用调用接口过于频繁,超过流控值(默认值是100次/60s)。 处理建议:联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 |
403 |
1010005 |
Invalid access token or appId. |
错误的token信息。 处理建议:请检查接口请求中所携带的accessToken是否有误。 |