# 查询项目下需求树(看板) - ShowIssueList #### 功能介绍 此接口用于获取看板项目需求列表 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI GET /v4/projects/{project_id}/issues 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html)。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | tracker_id | 否 | String | tracker_id | | iteration_ids | 否 | String | iteration_ids | | status_id | 否 | String | status_id | | module_id | 否 | String | module_id | | show_page_flag | 否 | String | show_page_flag | | page_no | 是 | String | 页码 | | page_size | 是 | String | 每页数量 | | key_word | 否 | String | 关键字 | #### 请求参数 无 #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 | | value | Array of [TestIssueVo] objects | 实际的数据类型：单个对象，集合 或 NULL | | reason | String | 业务失败的提示内容 | | page_size | Integer | 分页大小 | | page_no | Integer | 分页编码 | | has_more | Boolean | 是否有更多 | 表4TestIssueVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | author | [AuthorVo] object | 作者 | | domain | [NameAndIdVo] object | 租户 | | module | [NamePathAndPathVo] object | 模块 | | tracker | [NameAndIdVo] object | tracker | | status | [NameAndIdVo] object | 状态 | | priority | [NameAndIdVo] object | 优先级 | | severity | [NameAndIdVo] object | 严重程度 | | project | [ProjectVo] object | 项目 | | id | String | id | | subject | String | 标题 | | token | String | token | | board | [NameAndIdVo] object | 看板 | | relation | String | 需求层级关系 | | assigned_to | [AssignedVo] object | 负责人 | | sequence | String | xBoard项目工作项序列号 | | sequence_id | String | xBoard项目工作项序列号 | | created_on | String | 创建时间 | | start_date | String | 创建日期 | | fixed_version | [NameAndIdVo] object | 版本 | | plan_pi | [NameAndIdVo] object | pi | | assign_status | String | **参数解释**: 分配状态。 **取值范围**: - 0，设计待分配。 - 1，设计中。 - 2，设计完成（待分配）。 - 3，测试中。 - 4，已测试。 | | design_owner_id | String | 设计责任人id | | design_owner | String | 设计责任人名称 | | case_success_num | Integer | 用例成功个数 | | case_failure_num | Integer | 用例失败个数 | | case_disabled_num | Integer | 用例不可用个数 | | case_wait_verification_num | Integer | 用例待核查个数 | | case_blocking_num | Integer | 用例阻塞个数 | | case_wait_execute_num | Integer | 待执行的用例个数 | | case_total_num | Integer | 用例总数 | | domain_name | String | 租户名 | | domain_id | String | 租户id | | new_create_num | Integer | 新建个数 | | designing_num | Integer | 设计中个数 | | testing_num | Integer | 测试中个数 | | finished_num | Integer | 完成个数 | | issue_dynamic_count | Integer | 需求动态数量 | | defect_num | Integer | 需求对应缺陷个数 | | find_release_dev | String | 发现版本号 | | case_status_map | Map\ | 用例状态map | | parent_issue_id | String | 父需求id | | root_id | String | 根节点id | | due_date | String | 结束数据 | | is_parent | Boolean | 是否为父节点 | | have_child_dynamic | Boolean | 父工作项下是否有子工作项包含动态 | | tracker_id | String | 事件id | 表5AuthorVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 名称 | | id | String | id | | identifier | String | 标识符 | | first_name | String | 名 | | last_name | String | 姓 | | author_nick_name | String | 作者昵称 | | author_remark_name | String | 作者备注名 | 表6NamePathAndPathVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | ID | | name | String | 名称 | | path | String | 路径id | | path_name | String | 模块路径名称 | 表7ProjectVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | ID | | name | String | 名称 | | identifier | String | 标识符 | | type | String | **参数解释**: 项目类型 **取值范围**: - normal，普通项目。 - scrum，scrum项目。 - xboard，xboard项目。 - ipd，ipd项目。 | 表8AssignedVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 名称 | | id | String | id | | identifier | String | 标识符 | | first_name | String | 名 | | last_name | String | 姓 | | assigned_nick_name | String | 昵称 | | assigned_remark_name | String | 备注名 | 表9NameAndIdVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**: ID **取值范围**: 不涉及 | | name | String | **参数解释**: 名称 **取值范围**: 不涉及 | **状态码：400** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 不涉及 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 不涉及 | **状态码：401** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 不涉及 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 不涉及 | **状态码：404** 表12响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 不涉及 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 不涉及 | **状态码：500** 表13响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 不涉及 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 不涉及 | #### 请求示例 ``` get https://{endpoint}/v4/projects/75681cbb7c324e15a9eb8ee74a96a474/issues?page_no=1&page_size=10 ``` #### 响应示例 **状态码：200** OK ``` { "value" : { "author" : { "name" : "test01", "first_name" : "xx" }, "project" : { "name" : "新建项目" } } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。