Help Center> IoT Device Access> API Reference> 历史API> 应用侧API参考> 订阅管理-V3> 删除单个订阅
View PDF

删除单个订阅

接口说明

应用服务器若不再需要接收物联网平台推送的某个订阅通知消息时，可调用此接口删除指定的订阅配置，取消订阅。

URI

请求方法

DELETE

URI

/iocm/app/sub/v1.2.0/subscriptions/{subscriptionId}

传输协议

HTTPS

请求参数

参数

必选/可选

类型

位置

描述

app_key

必选

String

header

访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。

Authorization

必选

String

header

访问物联网平台的认证信息，值为“Bearer {accessToken}”，其中{accessToken}为调用鉴权接口返回的accessToken。

subscriptionId

必选

String(256)

path

订阅ID号，用于唯一标识一个订阅，在创建订阅时由物联网平台分配获得。

appId

可选

String(256)

query

订阅所属的应用ID，当删除授权应用下的订阅时才需要填写。

响应参数

Status Code: 204 No Content

请求示例

DELETE https://{host}:{port}/iocm/app/sub/v1.2.0/subscriptions/{subscriptionId}?appId={appId}
Content-Type: application/json
app_key: ******
Authorization: Bearer *****

正常响应示例

Status Code: 204 No Content

错误码

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

找不到资源。

处理建议：请检查订阅ID是否有误。
父主题： 订阅管理-V3