Deleting a Subscription
Typical Scenario
If an application does not need to receive a subscription notification pushed by the platform, the application can call this API to delete the specified subscription configuration and cancel the subscription.
API Function
This API is used by an application to delete the configuration information about a subscription by subscription ID on the platform.
API Description
1 | def deleteSingleSubscription(self, subscriptionId, appId, accessToken)
|
Parameter Description
| Parameter | Mandatory or Optional | Type | Location | Description |
|---|---|---|---|---|
| subscriptionId | Mandatory | String(256) | path | Identifies a subscription. |
| appId | Optional | String | query | If the device belongs to the current application, set this parameter to None. Otherwise, set this parameter to the ID of the authorized application. |
| accessToken | Mandatory | String | header | This parameter is set to the value of the accessToken obtained by calling the Authentication API. |
Response Parameters
void
Error Codes
| HTTP Status Code | Error Code | Error Description | Remarks |
|---|---|---|---|
| 403 | 100217 | The application has not been authorized. | The application has not been authorized. Recommended handling: In scenarios where applications are not authorized, ensure that request parameter appId is null. |
| 403 | 1010009 | The application calls the API at a frequency that exceeds the flow control threshold. | The application calls the API at a frequency that exceeds the flow control threshold (100 calls per minute by default). Recommended handling: Contact IoT platform maintenance personnel to adjust the flow control threshold or control the API call frequency. |
| 403 | 1010005 | Invalid access token or application ID. | The access token is invalid. Recommended handling: Check whether accessToken carried in the API request is correct. |
| 404 | 100225 | The resource cannot be found. | The resource does not exist. Recommended handling: Check whether subscriptionId is correct. |
Last Article: Querying Subscriptions in Batches
Next Article: Deleting Subscriptions in Batches
Did this article solve your problem?
Thank you for your score!Your feedback would help us improve the website.