更新时间:2022-02-24 GMT+08:00

批量删除订阅

典型场景

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

接口功能

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

接口描述

1
public function deleteBatchSubscriptions($dbsInDTO, $accessToken)

参数说明

参数

必选/可选

位置

描述

$dbsInDTO

必选

body

见下表DeleteBatchSubInDTO的描述。

$accessToken

必选

header

填写鉴权接口获取的accessToken。

DeleteBatchSubInDTO

参数

必选/可选

位置

描述

$appId

可选

query

第三方应用的身份标识,用于唯一标识一个应用。开发者可通过该标识来指定哪个应用来调用物联网平台的开放API。appid在物联网平台的SP Portal上创建应用时获得。此处填写授权应用的appid。

$notifyType

可选

query

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

  • bindDevice(绑定设备)
  • deviceAdded(添加新设备)
  • deviceInfoChanged(设备信息变化)
  • deviceDataChanged(设备数据变化)
  • deviceDatasChanged(设备数据批量变化)
  • deviceDeleted(删除设备)
  • messageConfirm(消息确认)
  • commandRsp(命令响应)
  • deviceEvent(设备事件)
  • serviceInfoChanged(服务信息变化)
  • deviceModelAdded(添加设备模型)
  • deviceModelDeleted(删除设备模型)
  • deviceDesiredPropertiesModifyStatusChanged(修改设备影子状态变更)
  • swUpgradeStateChangeNotify(软件升级状态变更通知)
  • swUpgradeResultNotify(软件升级结果通知)
  • fwUpgradeStateChangeNotify(固件升级状态变更通知)
  • fwUpgradeResultNotify(固件升级结果通知)

$callbackUrl

可选

query

订阅回调的URL地址。

$channel

可选

query

传输通道。

  • 当channel为空时,删除“传输通道”“MQTTS”“HTTP”的订阅。
  • 当channel为“MQTTS”时,删除“传输通道”“MQTTS”的订阅。
  • 当channel为“HTTP”时,删除“传输通道”“HTTP”的订阅。
  • 当channel取其他值时,不会删除订阅。

响应参数

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

找不到资源。

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