api:iptv:device:delete
Table of Contents
API : IPTV : Device : Delete
Introduction
This request will delete an existing device.
A device that uses DRM (type IOS, ANDROID, WEB) cannot be deleted without using the force option within the first 3 months after creation due to DRM license restrictions. Using the force option to delete it anyway will delete the device, but the license occupied by the device will still be reserved for the remainder of the period.
Request
| URL | https://api.telecomx.dk/iptv/device/DEVICE_ID | ||
|---|---|---|---|
| Method | DELETE | ||
| Access level | MANAGER or OWNER if customer has feature IPTVBUSINESS RESELLER if customer has IPTVBUSINESS or IPTVPRIVATE ADMIN |
||
| Params | DEVICE_ID | Id of the device to delete. | |
| Query | force | True to override DRM license binding (RESELLER or ADMIN only). | |
Query example
DELETE https://api.telecomx.dk/iptv/device/12345678901234567890AAAA DELETE https://api.telecomx.dk/iptv/device/12345678901234567890AAAA?force=true
Response
| JSON object | ||
|---|---|---|
| success | Boolean | True on success. |
| expires | Date | If force is used to delete a device within the DRM binding period, the device is marked as deleted and this is the date it will release the DRM license and disappear. |
Examples
{ success: true }
{ success: true, expires: '2017-01-01T00:00:00.000Z' }
Errors
| Error code | Message | Description |
|---|---|---|
| 404 | id | Not found |
| 409 | id | Device is using DRM and is still within the 90 days binding period |
| 403 | access_denied | Insufficient access level |
| 403 | deleted | Device has been deleted and is frozen until the 90 days DRM restriction expires |
| 500 | internal_error | <Unspecified> |
api/iptv/device/delete.txt · Last modified: 2019/11/27 15:53 by Per Møller