文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 自定义测试服务用例管理/ 查询迭代计划下用例URI和迭代下需求关联用例URI信息 - ShowCaseUrisInIterator
更新时间:2026-06-12 GMT+08:00
分享

查询迭代计划下用例URI和迭代下需求关联用例URI信息 - ShowCaseUrisInIterator

功能介绍

此接口用于查询迭代计划下用例URI和迭代下需求关联用例URI信息,根据入参的项目UUID和迭代URI查询对应的用例关联数据。

调用方法

请参见如何调用API

URI

GET /v4/{project_id}/iterators/{iterator_uri}/case-uris

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID

约束限制:

字符串类型,长度32位字符

取值范围:

项目uuid应符合如下规则:长度等于32位,包含大小写字母、数字

默认取值:

不涉及

iterator_uri

String

迭代uri

表2 Query参数

参数

是否必选

参数类型

描述

service_type

Integer

参数解释:

服务类型

约束限制:

不涉及

取值范围:

  • -1,全量用例。

  • 0,手工测试。

  • 1,接口自动化。

  • 7,功能自动化。

  • 8,WebUI自动化。

  • 100,自定义自动化(工厂)。

  • 11,性能自动化。

默认取值:

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

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

约束限制:

必传。

取值范围:

字符串长度不少于1,不超过10万。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

value

IteratorTestCaseUriVo object

请求返回的数据

表5 IteratorTestCaseUriVo

参数

参数类型

描述

all_case_uris

Array of strings

迭代计划关联用例URI集合

issue_related_case_uris

Array of strings

需求关联用例URI集合

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:401

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:404

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:500

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

查询迭代计划下用例URI和迭代下需求关联用例URI信息

get https://{endpoint}/v4/1b7179edc79a431f9711434124ac9f28/iterators/v90100010s9rnehl/case-uris

响应示例

状态码:200

OK

{
  "value" : {
    "all_case_uris" : [ "v90200010s9rmelv" ],
    "issue_related_case_uris" : [ "v90100010s2151fl", "v90200010s214j8g", "v90200010s9doojv", "v90200010s1h66bp" ]
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档