文档首页/ IoT物联网/ SDK参考/ 应用侧Python SDK API参考（联通用户专用）/ 订阅管理/ 批量删除订阅
更新时间：2024-07-01 GMT+08:00
查看PDF
分享

批量删除订阅

典型场景

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

接口功能

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

接口描述

1
 
def deleteBatchSubscriptions(self, dbsInDTO, accessToken)

参数说明

参数

必选/可选

类型

位置

描述

dbsInDTO

必选

DeleteBatchSubInDTO

body

见下表DeleteBatchSubInDTO的描述。

accessToken

必选

String

header

填写鉴权接口获取的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

找不到资源。

处理建议：请检查订阅类型是否有误。
父主题： 订阅管理

相关文档