标签列表
更新时间：2025-08-26
POST
https://qianfan.baidubce.com/v2/tag?Action=DescribeTags
权限说明
调用本API，需使用API Key鉴权方式。Authorization的值为Bearer
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
KeyWords
string
关键字搜索，模糊匹配key和value
可选
pageNo
integer
页数，默认 1
可选
pageSize
integer
默认 20
可选
请求结构
POST /v2/tag?Action=DescribeTags HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"keyWords":"test",
"pageNo":1,
"pageSize":20
}示例代码
请求示例
curl --location 'https://qianfan.baidubce.com/v2/tag?Action=DescribeTags' \
--header 'Authorization: Bearer authorization string' \
--header 'Content-Type: application/json' \
--data‘{
"keyWords":"test",
"pageNo":1,
"pageSize":20
}’返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
requestId
string
请求 ID
必选
pageSize
integer
每页的数量
必选
pageNo
integer
第几页
必选
hasMore
boolean
是否还有后续页
必选
total
integer
总的数量
必选
data
array
标签数据
必选
显示子属性
隐藏子属性
items
object {2}
显示子属性
隐藏子属性
key
string
仅支持中文、英文、数字、下划线（_）、中划线（-）、英文点（.），长度1-50
必选
values
array
仅支持中文、英文、数字、下划线（_）、中划线（-）、英文点（.），长度1-50
必选
显示子属性
隐藏子属性
items
string
最多可添加 300 个标签值
JSON
HTTP/1.1 200 OK
{
"data": [
{
"key": "ces",
"values": [
"Das"
]
},
{
"key": "lwcesh",
"values": [
"lw102",
"lwdead"
]
},
{
"key": "lwcesh1",
"values": [
"lw102",
"lwdead"
]
}
],
"pageSize": 10,
"pageNo": 1,
"hasMore": false,
"total": 3,
"request_id": "8dde7baa-8ba4-4f83-8b54-52a31d6c4777"
}JSON
HTTP/1.1 401
{
"requestId": "ae2225f7-1c2e-427a-a1ad-5413b762957d",
"code": "PermissionDeniedError",
"message": "没有权限"
}