新增标签
更新时间：2025-04-01
接口描述
新增标签
权限说明
调用本API，需使用API Key鉴权方式。Authorization的值为Bearer <AppBuilder API Key>。获取API Key流程，请查看授权
接口定义
| URL | /v2/tag?Action=CreateTag |
|---|---|
| Method | POST |
| Content-Type | application/json |
| Authorization | 请求签名(Bearer <AppBuilder API Key>) |
请求结构
POST /v2/tag?Action=CreateTag HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"key": "娱乐",
"values": ["电影","综艺"],
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| key | string | 是 | 标签key。 可包含大小写字母、数字、中文以及-_ /.特殊字符，长度1-50，（每个用户只允许创建20个 key） |
| values | List[string] | 是 | 标签values。 可包含大小写字母、数字、中文以及-_ /.特殊字符，长度1-50， 每个key ,最多可包含50的 value 值 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 字段 | 类型 | 必然存在 | 说明 |
|---|---|---|---|
| requestId | string | 是 | 请求ID |
请求curl 示例
curl --location 'https://qianfan.baidubce.com/v2/tag?Action=CreateTag' \
--header 'Authorization: Bearer authorization string' \
--header 'Content-Type: application/json' \
--data '{
"key": "娱乐",
"values": ["电影","综艺"],
}'正确响应示例
HTTP/1.1 200 OK
{
"requestId": "f5fb7546-33d5-47ae-97e4-7b8ce9e02d55",
}错误响应示例
HTTP/1.1 401
{
"requestId": "ae2225f7-1c2e-427a-a1ad-5413b762957d",
"code": "PermissionDeniedError",
"message": "没有权限"
}