# 说明
获取迭代类别列表
TAPD迭代支持多类别/多模板, 每一个类别和模板是一一对应关系, 且对应同一套创建页预填写字段配置。此接口可以获取指定项目下所有的迭代类别。
获取迭代类别后, 可以:
- 通过 获取迭代类别默认模板字段配置 接口取得该类别迭代的创建页字段配置;
- 在 创建迭代 时指定并传递
entity_type
和workitem_type_id
来预填迭代字段和自动推导计算迭代关键日期。
# url
https://api.tapd.cn/iterations/workitem_types
# 支持格式
JSON/XML(默认JSON格式)
# HTTP请求方式
GET
# 请求数限制
默认返回 30 条。可通过传 limit 参数设置,最大取 200。也可以传 page 参数翻页
# 请求参数
字段名 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
workspace_id | 是 | integer | 项目ID |
# 调用示例及返回结果
# 获取迭代类别列表
# curl 使用 Basic Auth 鉴权调用示例
curl -u 'api_user:api_password' -d 'workspace_id=20375553' 'https://api.tapd.cn/iterations/workitem_types?workspace_id=20375553'
# 返回结果
{
"status": 1,
"data": [
{
"WorkitemType": {
"id": "1020375553000072217",
"workspace_id": "20375553",
"entity_type": "release",
"name": "发布计划类别1",
"creator": "TAPD system",
"created": "2023-03-23 15:23:35",
"modified": "2023-12-13 15:46:41"
}
},
{
"WorkitemType": {
"id": "1020375553000070695",
"workspace_id": "20375553",
"entity_type": "iteration",
"name": "迭代类别1",
"creator": "TAPD system",
"created": "2022-12-13 15:06:20",
"modified": "2022-12-13 15:06:20"
}
},
{
"WorkitemType": {
"id": "1020375553860932091",
"workspace_id": "20375553",
"entity_type": "release",
"name": "发布计划类别2",
"creator": "xinweihe",
"created": "2023-11-15 22:16:27",
"modified": "2023-12-13 09:59:49"
}
}
],
"info": "success"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39