Add 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/create
Request Method
POST
Interface Constraints
- The interface supports both HTTP and HTTPS. HTTPS is recommended to ensure interface security. The interface has a call frequency limit. 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 never be saved or used directly on the client side. All APIs must be called through the customer's own server to relay to the POLYV server to obtain response data. See signature generation rules |
Request Body Parameter Description
| Parameter | Required | Type | Description |
|---|---|---|---|
| name | true | String | Tag name |
Example
https://api.polyv.net/live/v4/material/label/create?appId=xxx&sign=A69559D6EBF130B9C0F60807459FC311×tamp=1642733791590
Request Body Parameters
{
"name": "重要",
}
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 debugging and troubleshooting, should not be tied to business logic |
| error | Object | Error information when the status code is non-200 See Error field description |
| data | Boolean | Whether the addition was successful, true for success, false for failure |
Error Parameter Description
| Parameter | Type | Description |
|---|---|---|
| code | Integer | Error code, used to identify the specific error cause |
| desc | String | Error description, corresponding 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, Duplicate Tag Name
{
"code": 400,
"status": "error",
"requestId": "3b86d4c5-3dc2-472e-8a38-53e2b76502f3",
"error": {
"code": 62022,
"desc": "素材库标签已存在"
},
"data": false,
"success": false
}
Error Example
{
"code": 400,
"status": "error",
"error": {
"code": 10003,
"desc": "时间戳过期"
},
"success": false
}
