批量删除订阅
典型场景
第三方应用若不再需要接收物联网平台推送的订阅通知消息,或者不再需要接收某类订阅通知消息,可调用此接口批量删除订阅配置,取消订阅。
接口功能
支持第三方应用在物联网平台批量删除订阅配置,可删除全部订阅,或删除指定订阅类型的所有订阅,或删除指定回调URL地址的所有订阅。
接口描述
1 |
public function deleteBatchSubscriptions($dbsInDTO, $accessToken)
|
参数说明
参数 |
必选/可选 |
位置 |
描述 |
---|---|---|---|
$dbsInDTO |
必选 |
body |
见下表DeleteBatchSubInDTO的描述。 |
$accessToken |
必选 |
header |
填写鉴权接口获取的accessToken。 |
参数 |
必选/可选 |
位置 |
描述 |
---|---|---|---|
$appId |
可选 |
query |
第三方应用的身份标识,用于唯一标识一个应用。开发者可通过该标识来指定哪个应用来调用物联网平台的开放API。appid在物联网平台的SP Portal上创建应用时获得。此处填写授权应用的appid。 |
$notifyType |
可选 |
query |
通知类型,第三方应用可以根据通知类型对消息分别进行处理。
|
$callbackUrl |
可选 |
query |
订阅回调的URL地址。 |
$channel |
可选 |
query |
传输通道。
|
响应参数
Status Code: 204 No Content
错误码
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 |
找不到资源。 处理建议:请检查订阅类型是否有误。 |