新增标签
更新时间：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>) |
请求结构
Plain Text
1POST /v2/tag?Action=CreateTag HTTP/1.1
2HOST: qianfan.baidubce.com
3Authorization: authorization string
4Content-Type: application/json
5
6{
7 "key": "娱乐",
8 "values": ["电影","综艺"],
9}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| key | string | 是 | 标签key。 可包含大小写字母、数字、中文以及-_ /.特殊字符，长度1-50，（每个用户只允许创建20个 key） |
| values | List[string] | 是 | 标签values。 可包含大小写字母、数字、中文以及-_ /.特殊字符，长度1-50， 每个key ,最多可包含50的 value 值 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 字段 | 类型 | 必然存在 | 说明 |
|---|---|---|---|
| requestId | string | 是 | 请求ID |
请求curl 示例
Plain Text
1curl --location 'https://qianfan.baidubce.com/v2/tag?Action=CreateTag' \
2--header 'Authorization: Bearer authorization string' \
3--header 'Content-Type: application/json' \
4--data '{
5 "key": "娱乐",
6 "values": ["电影","综艺"],
7}'正确响应示例
Plain Text
1HTTP/1.1 200 OK
2{
3 "requestId": "f5fb7546-33d5-47ae-97e4-7b8ce9e02d55",
4}错误响应示例
Plain Text
1HTTP/1.1 401
2{
3 "requestId": "ae2225f7-1c2e-427a-a1ad-5413b762957d",
4 "code": "PermissionDeniedError",
5 "message": "没有权限"
6}