文档首页/需求管理 CodeArts Req/API参考/API/Scrum项目的状态/查询项目的状态列表
更新时间：2025-09-10 GMT+08:00
查看PDF
分享

查询项目的状态列表

功能介绍

查询项目的状态列表

URI

GET /v4/projects/{project_id}/statuses

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

devcloud项目的32位id

表2 Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

查询偏移量

limit

否

Integer

一次返回的数据,最小1,最大100

tracker_id

否

Integer

自定义字段支持的工作项类型 2任务/Task,3缺陷/Bug,5Epic,6Feature,7Story

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

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

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

total

Integer

状态总数

issue_statuses

Array of IssueStatus objects

状态列表

表5 IssueStatus

参数

参数类型

描述

id

String

状态uuid

status_id

Integer

状态数字id

name

String

状态名称

tracker_ids

Array of integers

关联的工作项类型列表

status_attribute

StatusAttribute object

状态属性类型 开始态,进行态,结束态

表6 StatusAttribute

参数

参数类型

描述

id

Integer

状态属性id

name

String

状态属性名称

状态码：400

表7 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

状态码：401

表8 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

请求示例

Get https://{endpoint}/v4/projects/0792b7d26cb74bd799cbae80063dc74a/statuses

响应示例

状态码：200

OK

{
  "total" : 1,
  "issue_statuses" : [ {
    "id" : "123cefde62004de2b62b5e8dd2c2b3af",
    "status_id" : 1,
    "name" : "新建",
    "tracker_ids" : [ 0 ],
    "status_attribute" : {
      "id" : 1,
      "name" : "string"
    }
  } ]
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

错误码

请参见错误码。