# 说明
获取并行工作流节点信息及其与状态的归属关系。仅需求支持并行工作流
# url
https://api.tapd.cn/workflows/step_map
# 支持格式
JSON/XML(默认JSON格式)
# HTTP请求方式
GET
# 请求数限制
一次只能获取一个项目的工作流的节点信息
# 请求参数
字段名 | 必选 | 类型及范围 | 说明 | 特殊规则 |
---|---|---|---|---|
workspace_id | 是 | integer | 项目ID | |
system | 是 | string | 系统名,当前仅支持需求 story | |
workitem_type_id | 是 | integer | 需求类别id(获取需求类别ID接口:获取需求类别查询需求状态时需必传 |
# 调用示例及返回结果
# 获取项目需求工作流状态中英文名对应关系
# curl 使用 Basic Auth 鉴权调用示例
curl -u 'api_user:api_password' 'https://api.tapd.cn/workflows/step_map?system=story&workspace_id=10158231'
# 返回结果
{
"status": 1,
"data": [
{
"name": "new",
"label": "开始阶段",
"steps": [
{
"name": "step_begin",
"label": "创建"
},
{
"name": "step_2970811_1",
"label": "待处理"
}
]
},
{
"name": "in_progress",
"label": "执行阶段",
"steps": [
{
"name": "step_2970811_2",
"label": "执行节点1"
},
{
"name": "step_2970811_3",
"label": "执行节点2"
}
]
},
{
"name": "closed",
"label": "结束阶段",
"steps": [
{
"name": "step_end",
"label": "结束"
}
]
},
{
"name": "workflow_suspended",
"label": "流程挂起",
"steps": []
},
{
"name": "workflow_end",
"label": "流程终止",
"steps": []
}
],
"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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
# 返回字段说明
字段 | 说明 |
---|---|
name | 英文名 |
label | 中文名 |
step | 状态下的节点 |