Update Material Library Tag
Updated: 2026-02-26 17:32:15
API Description
1、更新账号下的素材库标签信息。
2、接口支持https协议
API URL
https://api.polyv.net/live/v4/material/label/update
Request Method
POST
API Constraints
- The API supports both HTTP and HTTPS. HTTPS is recommended for security. API calls have frequency limits. See details
Request Parameter Description
| Parameter | Required | Type | Description |
|---|---|---|---|
| appId | true | String | Account appId See details |
| 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 never be saved or used directly on the client. All APIs must be called through the customer's own server to relay requests to the POLYV server and retrieve responses. See signature generation rules |
Request Body Parameter Description
| Parameter | Required | Type | Description |
|---|---|---|---|
| id | true | Long | Tag ID. Tag IDs can be obtained via the query material library tag list API |
| name | true | String | Tag name |
Example
https://api.polyv.net/live/v4/material/label/update?appId=xxx&sign=A69559D6EBF130B9C0F60807459FC311×tamp=1642733791590
Request Body Parameters
{
"id": 1,
"name": "重要"
}
Response Parameter Description
| Parameter | Type | Description |
|---|---|---|
| code | Integer | Response status code. 200 indicates success, non-200 indicates failure |
| status | String | Response result, determined by business logic. Returns "success" on success, "error" on failure |
| success | Boolean | Whether the request was successful |
| requestId | String | Request ID, a unique UUID generated for each request. Only used for troubleshooting and debugging, not for business logic |
| error | Object | Error information when status code is non-200 See Error field description |
| data | Boolean | Whether the update was successful. true for success, false for failure |
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 system-wide 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": false,
"success": false
}
Error Example
{
"code": 400,
"status": "error",
"error": {
"code": 10003,
"desc": "时间戳过期"
},
"success": false
}
