更新时间:2024-07-01 GMT+08:00
分享

批量删除订阅

典型场景

第三方应用若不再需要接收物联网平台推送的订阅通知消息,或者不再需要接收某类订阅通知消息,可调用此接口批量删除订阅配置,取消订阅。

接口功能

支持第三方应用在物联网平台批量删除订阅配置,可删除全部订阅,或删除指定订阅类型的所有订阅,或删除指定回调URL地址的所有订阅。

接口描述

1
void deleteBatchSubscriptions(DeleteBatchSubInDTO dbsInDTO, String accessToken) throws NorthApiException

参数说明

参数

必选/可选

类型

位置

描述

dbsInDTO

必选

DeleteBatchSubInDTO

body

见下表DeleteBatchSubInDTO的描述。

accessToken

必选

String

header

如果调用了定时刷新token接口,此参数值可以填写null,否则要填写鉴权接口获取的accessToken。

DeleteBatchSubInDTO

参数

必选/可选

类型

位置

描述

appId

可选

String(256)

query

设备或者规则等订阅内容主体所属的appId。

notifyType

可选

String(256)

query

通知类型,第三方应用可以根据通知类型对消息分别进行处理。

  • bindDevice(绑定设备)
  • deviceAdded(添加新设备)
  • deviceInfoChanged(设备信息变化)
  • deviceDataChanged(设备数据变化)
  • deviceDatasChanged(设备数据批量变化)
  • deviceCapabilitiesChanged(设备服务能力变化,订阅后推送设备服务能力变化通知)
  • deviceCapabilitiesAdded(设备服务能力增加,订阅后推送设备服务能力增加通知)
  • deviceCapabilitiesDeleted(设备服务能力删除,订阅后推送设备服务能力删除通知)
  • deviceDeleted(删除设备)
  • messageConfirm(消息确认)
  • commandRsp(命令响应)
  • deviceDesiredPropertiesModifyStatusChanged(修改设备影子状态变更)
  • swUpgradeStateChangeNotify(软件升级状态变更通知)
  • swUpgradeResultNotify(软件升级结果通知)
  • fwUpgradeStateChangeNotify(固件升级状态变更通知)
  • fwUpgradeResultNotify(固件升级结果通知)

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

Invalid access token or appId.

错误的token信息。

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

404

100225

The resource is not found

找不到资源。

处理建议:请检查订阅类型是否有误。

相关文档