更新时间:2025-08-21 GMT+08:00
分享

添加系统自定义状态

功能介绍

添加系统自定义状态。

调用方法

请参见如何调用API

URI

POST /v2/issue-status/project-status-config

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

definedName

String

参数解释

自定义状态名称。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

description

String

参数解释

自定义状态的描述。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

projectUUId

String

参数解释

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

约束限制

32位的数字和字母组成的字符串。

取值范围

不涉及。

默认取值

不涉及。

statusAttribute

Integer

参数解释

自定义状态的属性id。

约束限制

不涉及。

取值范围

0(开始态)

1(进行态)

2(结束态)

默认取值

不涉及。

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

result

result object

请求返回结果

status

String

参数解释:

返回结果。

取值范围:

success: 返回成功

error: 返回失败

表3 result

参数

参数类型

描述

definedName

String

参数解释:

自定义状态名称。

取值范围:

不涉及。

flag

Integer

参数解释:

状态是否为自定义状态。

取值范围:

0(不是自定义状态)

1(是自定义状态)

id

String

参数解释:

自定义状态id。

取值范围:

不涉及。

position

Integer

参数解释

自定义状态在状态管理列表的位置。

取值范围

不涉及。

projectUUId

String

参数解释

项目的32位UUID。

取值范围

不涉及。

statusAttribute

Integer

参数解释:

自定义状态属性。

取值范围:

0(开始态)

1(进行态)

2(结束态)

statusId

Integer

参数解释:

自定义状态数字id。

取值范围:

不涉及。

description

String

参数解释:

自定义状态的描述。

取值范围:

不涉及。

请求示例

POST http://{endpoint}/v2/issue-status/project-status-config

{
  "projectUUId" : "af2d9ea776204a4395e238dd156b2ca9",
  "definedName" : "测试test",
  "description" : "描述示例",
  "statusAttribute" : 35098945
}

响应示例

状态码:200

返回消息。

{
  "result" : {
    "id" : "827ae86a6b4c431c88a668dd996b74b1",
    "statusId" : 7,
    "definedName" : "22222",
    "position" : 2,
    "flag" : 1,
    "projectUUId" : "af2d9ea776204a4395e238dd156b2ca9",
    "description" : "111",
    "statusAttribute" : 34746202
  },
  "status" : "success"
}

状态码

状态码

描述

200

返回消息。

错误码

请参见错误码

相关文档