查询项目的状态列表
功能介绍
查询项目的状态列表
URI
GET /v4/projects/{project_id}/statuses
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
devcloud项目的32位id |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
offset |
否 |
Integer |
查询偏移量 |
|
limit |
否 |
Integer |
一次返回的数据,最小1,最大100 |
|
tracker_id |
否 |
Integer |
自定义字段支持的工作项类型 2任务/Task,3缺陷/Bug,5Epic,6Feature,7Story |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total |
Integer |
状态总数 |
|
issue_statuses |
Array of IssueStatus objects |
状态列表 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
状态uuid |
|
status_id |
Integer |
状态数字id |
|
name |
String |
状态名称 |
|
tracker_ids |
Array of integers |
关联的工作项类型列表 |
|
status_attribute |
StatusAttribute object |
状态属性类型 开始态,进行态,结束态 |
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_msg |
String |
错误描述 |
|
error_code |
String |
错误码 |
状态码:401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
错误码
请参见错误码。