获取标签列表
更新时间：2025-09-16
POST
https://qianfan.baidubce.com/v2/tag?Action=DescribeTags
获取标签列表
权限说明
调用本API，需使用API Key鉴权方式。Authorization的值为Bearer <API Key>。获取API Key流程，请查看授权
请求参数
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
页数
必选
total
integer
总数据量
必选
data
array
标签数据
必选
显示子属性
隐藏子属性
items
object {2}
显示子属性
隐藏子属性
key
string
标签
必选
value
array
标签值
必选
显示子属性
隐藏子属性
items
string
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,
"total": 3,
"request_id": "8dde7baa-8ba4-4f83-8b54-52a31d6c4777"
}JSON
HTTP/1.1 401
{
"requestId": "ae2225f7-1c2e-427a-a1ad-5413b762957d",
"code": "PermissionDeniedError",
"message": "没有权限"
}