根据用例URI集合查询用例列表 - ShowTestCaseListByUris

功能介绍

此接口用于根据传入的用例编号集合查询用例列表信息,返回对应用例的详情数据

调用方法

请参见如何调用API。

URI

POST /v4/{project_id}/testcases

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
case_uris	否	Array of strings	用例URI集合，单次查询支持1~50个用例uri

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
status	String	参数解释: 调用此接口的响应状态。取值范围: success，表示接口调用成功。 error，表示接口调用失败。
result	ResultValueListTestCaseVo object	查询用例列表返回参数
error	ApiError object	错误信息
request_id	String	由接口调用方传入，建议使用UUID保证请求的唯一性。
server_address	String	本次请求的受理的服务地址

表4 ResultValueListTestCaseVo
参数	参数类型	描述
total	Integer	起始记录数大于实际总条数时，值为0，分页请求才有此值
value	Array of TestCaseVo objects	实际的数据类型：单个对象，集合或 NULL
reason	String	业务失败的提示内容
page_size	Integer	分页大小
page_no	Integer	分页编码
has_more	Boolean	是否有更多

表5 TestCaseVo
参数	参数类型	描述
uri	String	参数解释用例ID 取值范围不涉及
number	String	参数解释用例编号取值范围不涉及
name	String	参数解释用例名称取值范围不涉及
rank	String	参数解释用例等级取值范围不涉及
dr_relation_id	String	参数解释工作项id 取值范围不涉及
status_code	String	参数解释状态ID 取值范围不涉及
status_name	String	参数解释状态名称取值范围不涉及
author	String	参数解释创建人名称取值范围不涉及
author_id	String	参数解释创建人ID 取值范围不涉及
owner	String	参数解释处理人名称取值范围不涉及
project_uuid	String	参数解释项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 取值范围不涉及
test_type	String	参数解释: 测试类型取值范围: 1，功能性测试。 2，兼容性测试。 4，性能测试。 15，易用性测试。 22，可靠性测试。 14，安全性测试。 21，可服务性测试。
creation_date	String	参数解释创建时间取值范围不涉及

表6 ApiError
参数	参数类型	描述
code	String	业务失败的错误编码
reason	String	业务失败的提示内容

状态码：400

表7 响应Body参数
参数	参数类型	描述
error_code	String	接口调用失败错误码
error_msg	String	接口调用失败错误信息

状态码：401

表8 响应Body参数
参数	参数类型	描述
error_code	String	接口调用失败错误码
error_msg	String	接口调用失败错误信息

状态码：404

表9 响应Body参数
参数	参数类型	描述
error_code	String	接口调用失败错误码
error_msg	String	接口调用失败错误信息

状态码：500

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	接口调用失败错误码
error_msg	String	接口调用失败错误信息

请求示例

post https://{endpoint}/v4/projects/f3087a82b44744c29a1bd69ab6ada154/testcases

{
  "case_uris" : [ "213123123", "213232323" ]
}

响应示例

状态码：200

{
  "value" : [ {
    "uri" : "12312312",
    "name" : "新建用例1",
    "rank" : "1"
  }, {
    "uri" : "12312313",
    "name" : "新建用例2",
    "rank" : "3"
  } ]
}