# 说明

获取并行工作流节点信息及其与状态的归属关系。仅需求支持并行工作流

# 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

# 返回字段说明

字段 说明
name 英文名
label 中文名
step 状态下的节点
上次更新: 2025-01-15 21:03:18