批量删除订阅
典型场景
第三方应用若不再需要接收物联网平台推送的订阅通知消息,或者不再需要接收某类订阅通知消息,可调用此接口批量删除订阅配置,取消订阅。
接口功能
支持第三方应用在物联网平台批量删除订阅配置,可删除全部订阅,或删除指定订阅类型的所有订阅,或删除指定回调URL地址的所有订阅。
接口描述
1 |
void deleteBatchSubscriptions(DeleteBatchSubInDTO dbsInDTO, String accessToken) throws NorthApiException
|
参数说明
参数 |
必选/可选 |
类型 |
位置 |
描述 |
---|---|---|---|---|
dbsInDTO |
必选 |
DeleteBatchSubInDTO |
body |
见下表DeleteBatchSubInDTO的描述。 |
accessToken |
必选 |
String |
header |
DeleteBatchSubInDTO
参数 |
必选/可选 |
类型 |
位置 |
描述 |
---|---|---|---|---|
appId |
可选 |
String(256) |
query |
设备或者规则等订阅内容主体所属的appId。 |
notifyType |
可选 |
String(256) |
query |
通知类型,第三方应用可以根据通知类型对消息分别进行处理。
|
callbackUrl |
可选 |
String(256) |
query |
订阅回调的URL地址。 |
响应参数
void
错误码
Http状态码 |
错误码 |
错误描述 |
说明 |
---|---|---|---|
403 |
100217 |
The application hasn't been authorized. |
应用未被授权。 处理建议:若非应用授权场景,请确认请求参数中的appId为空。 |
403 |
1010009 |
app throttle exceed. |
应用调用接口过于频繁,超过流控值(默认值是100次/60s)。 处理建议:联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 |
403 |
1010005 |
App_key or access_token is invalid. |
错误的token信息。 处理建议:请检查接口请求中所携带的accessToken是否有误。 |
404 |
100225 |
The resource is not found |
找不到资源。 处理建议:请检查订阅类型是否有误。 |