# 说明
返回符合查询条件的所有自定义标签（分页显示，默认一页30条）
# url
https://api.tapd.cn/label
# 支持格式
JSON/XML（默认JSON格式）
# HTTP请求方式
GET
# 请求数限制
默认返回 30 条。可通过传 limit 参数设置，最大取 200。也可以传 page 参数翻页
# 请求参数
| 字段名 | 必选 | 类型及范围 | 说明 | 特殊规则 |
|---|---|---|---|---|
| workspace_id | 是 | integer | 项目ID | |
| id | 否 | integer | id | 支持多ID查询 |
| name | 否 | string | 标签名称 | 支持模糊匹配 |
| creator | 否 | string | 创建人 | |
| created | 否 | datetime | 创建时间 | 支持时间查询 |
| limit | 否 | integer | 设置返回数量限制，默认为30 | |
| page | 否 | integer | 返回当前数量限制下第N页的数据，默认为1（第一页） | |
| order | 否 | string | 排序规则，规则：字段名 ASC或者DESC，然后 urlencode | 如按创建时间逆序：order=created%20desc |
# 调用示例及返回结果
# 获取项目下的标签信息
# curl 使用 Basic Auth 鉴权调用示例
curl -u 'api_user:api_password' 'https://api.tapd.cn/label?workspace_id=10158231'
curl 'https://api.tapd.cn/label?workspace_id=10158231&access_token=ACCESS_TOKEN'
# 返回结果
{
"status": 1,
"data": [
{
"LabelPool": {
"id": "1220358527000001547",
"workspace_id": "20358527",
"name": "啦啦",
"color": "4",
"creator": "huanjinxie",
"modifier": "",
"created": "2022-09-25 21:37:44",
"modified": "2022-09-25 21:37:44",
"color_value": "#748096"
}
}
],
"info": "success"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# 标签字段说明
# 标签重要字段说明
| 字段 | 说明 |
|---|---|
| id | id |
| name | 标签名称 |
| color | 颜色ID，枚举值，可选[1,2,3,4] |
| color_value | 实际颜色值 [1 => #2FB280, 2 => #F85E5E,3 => #FFAF21 ,4 => #748096] |
| created | 创建时间 |
| workspace_id | 项目ID |