更新时间:2025-07-01 GMT+08:00

工作项流程流转

功能介绍

工作项流程流转。

调用方法

请参见如何调用API

URI

POST /v1/ipdprojectservice/projects/{project_id}/work-item/flow/transfer

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目的32位uuid,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。

约束限制

正则表达式,^[A-Za-z0-9]{32}$。

取值范围

不涉及。

默认取值

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

必传。

取值范围:

最小长度:10,最大长度:32768。

默认取值:

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

id

String

参数解释:

工作项唯一Id。

约束限制:

正则表达式,^([0-9]{18,19})$。

取值范围:

不涉及。

默认取值:

不涉及。

issue_category

String

参数解释:

工作项类型。

约束限制:

正则表达式:"^(RR|IR|AR|SR|Bug|FE|Task|US|Epic|SF)"。

取值范围:

RR、IR、AR、SR、Bug、FE、Task、US、Epic、SF

默认取值:

不涉及。

flow_code

String

参数解释:

工作项流转code。

约束限制:

正则表达式:"^[\s\S]{1,500}"。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

status

String

参数解释:

状态码。

取值范围:

不涉及。

message

String

参数解释:

响应信息。

取值范围:

不涉及。

请求示例

POST /v1/ipdprojectservice/projects/39d30be0842e4e5d8e28ee7e1712c6a2/work-item/flow/transfer

{
  "id" : "1135239465657217024",
  "issue_category" : "Bug",
  "flow_code" : "__virtual_Analyse__2__Fixed"
}

响应示例

状态码:200

成功响应

{
  "status" : "success",
  "message" : null
}

状态码

状态码

描述

200

成功响应

错误码

请参见错误码