Delete Material Library Tag
Updated: 2026-02-26 17:32:15
Interface Description
1、删除账号下的素材库标签。
2、接口支持https协议
Interface URL
https://api.polyv.net/live/v4/material/label/delete
Request Method
POST
Interface Constraints
- The interface supports both HTTP and HTTPS. HTTPS is recommended to ensure interface security. Interface calls have frequency limits. See details
Request Parameter Description
| Parameter | Required | Type | Description |
|---|---|---|---|
| appId | true | String | Account appId See details on obtaining the key |
| timestamp | true | Long | Current 13-digit millisecond timestamp, valid within 3 minutes |
| sign | true | String | Signature, a 32-character uppercase MD5 value. The appSecret key used to generate the signature is critical for communication data security. It must not be stored or used directly on the client. All APIs must be called through the customer's own server to relay requests to the POLYV server for response data. See signature generation rules |
Request Body Parameter Description
| Parameter | Required | Type | Description |
|---|---|---|---|
| id | true | Long | Tag ID. Tag ID can be obtained via the query material library tag list interface |
Example
https://api.polyv.net/live/v4/material/label/delete?appId=xxx&sign=A69559D6EBF130B9C0F60807459FC311×tamp=1642733791590
Request Body Parameters
{
"id": 123456789
}
Response Parameter Description
| Parameter | Type | Description |
|---|---|---|
| code | Integer | Response status code, 200 for success, non-200 for failure |
| status | String | Response result, determined by business logic, returns success on success, error on failure |
| success | Boolean | Whether the response was successful |
| requestId | String | Request ID, a unique UUID generated for each request, used only for troubleshooting and debugging, should not be tied to business logic |
| error | Object | Error information when status code is non-200 See Error field description |
| data | Boolean | Deletion result, true indicates successful deletion |
Error Parameter Description
| Parameter | Type | Description |
|---|---|---|
| code | Integer | Error code, used to identify the specific error |
| desc | String | Error description, corresponds to error.code |
Response Example
For global system error descriptions, see Global Error Description
Success Example
{
"code": 200,
"status": "success",
"requestId": "1472d84d-7221-4221-b604-5c9ed07461ca",
"data": true,
"success": true
}
Failure Example, Tag Not Found
{
"code": 400,
"status": "error",
"requestId": "3b86d4c5-3dc2-472e-8a38-53e2b76502f3",
"error": {
"code": 62044,
"desc": "素材标签不存在"
},
"data": null,
"success": false
}
Error Example
{
"code": 400,
"status": "error",
"error": {
"code": 10003,
"desc": "时间戳过期"
},
"success": false
}
