文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试用例检查管理/ 查询版本级用例规范检查用例列表 - ShowVersionCheckTestCasesFour
更新时间:2025-12-27 GMT+08:00
分享

查询版本级用例规范检查用例列表 - ShowVersionCheckTestCasesFour

功能介绍

此接口用于查询版本级用例规范检查用例列表,对应页面 测试 -> 测试用例 -> 列表右侧"更多" -> 规范检查

调用方法

请参见如何调用API

URI

POST /v4/{project_id}/versions/{version_uri}/rule-check/tasks/{task_uri}/violation-cases

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

version_uri

String

分支版本uri

task_uri

String

任务uri

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

severity

Array of integers

严重程度(1提示 2一般 3严重)

page_size

Integer

每页数量

page_no

Integer

页码

case_name

String

名称

sort_field

String

排序字段

sort_type

String

参数解释:

排序方式

约束限制:

不涉及

取值范围:

  • ASC,升序。

  • DESC,降序。

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

value

Array of TestCaseRuleCheckViolationCaseVo objects

结果详细

表4 TestCaseRuleCheckViolationCaseVo

参数

参数类型

描述

uri

String

主键

severity

Integer

严重程度

status

Integer

问题状态 (0:未解决,1:已解决,2:忽略)

suggestions

String

修改意见

check_task_uri

String

检查任务uri

case_uri

String

违规用例uri

case_name

String

违规用例名称

case_number

String

违规用例编号

module_id

String

违规用例模块id

case_creator

String

违规用例创建人id

severity_name

String

严重程度名称

violation_type

String

参数解释:

问题类型

取值范围:

  • 用例重复问题。

  • 用例名称问题。

  • 用例编号问题。

  • 用例描述问题。

  • 前置条件问题。

  • 测试步骤问题。

  • 步骤描述问题。

  • 预期结果问题。

  • 归属目录问题。

  • 用例标签问题。

  • 测试版本号问题。

  • 脚本路径问题。

violation_cause

String

问题原因

field_name

String

违规用例字段名称

rule_link

String

规则链接

rule_description

String

规则描述

violation_content

String

问题内容

repeated_testcase_count

Integer

相似用例总数

repeated_case_list

Array of TestCaseRuleCheckRepeatedRelationTestCaseVo objects

用例相似用例信息列表

表5 TestCaseRuleCheckRepeatedRelationTestCaseVo

参数

参数类型

描述

name

String

名称

number

String

编号

rank

Integer

级别

similarity

String

用例相似度

service_type

Integer

参数解释:

服务类型

取值范围:

  • -1,全量用例。

  • 0,手工测试。

  • 1,接口自动化。

  • 7,功能自动化。

  • 8,WebUI自动化。

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

  • 11,性能自动化。

version_uri

String

版本URI

version_name

String

版本名称

状态码: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

接口调用失败错误信息

请求示例

post https://{endpoint}/v4/704a12bbe517445ab75b855b77888d68/versions/v92t000107oi68nt/rule-check/tasks/v93400010ias0016/violation-cases

{
  "page_size" : 10,
  "page_no" : 1
}

响应示例

状态码:200

OK

{
  "total" : 4,
  "value" : [ {
    "uri" : "v90800010s20eif5",
    "severity" : 3,
    "status" : 0,
    "suggestions" : "请编写测试步骤1描述",
    "check_task_uri" : "v90800010s20eia5",
    "case_uri" : "v90200010s1h66bp",
    "case_name" : "样例功能用例",
    "case_number" : "008",
    "case_creator" : "a17801c5d15f46e28112eec8a880683d",
    "severity_name" : "严重",
    "violation_type" : "步骤描述问题",
    "violation_cause" : "违反规则7.1.1,测试步骤1描述为空",
    "field_name" : "步骤描述",
    "rule_link" : "",
    "rule_description" : "规则7.1.1 测试步骤、预期结果为必填项。",
    "violation_content" : "{\"content\":\"\",\"num\":1}"
  }, {
    "uri" : "v90810s20eif5dbd",
    "severity" : 3,
    "status" : 0,
    "suggestions" : "请编写测试步骤1预期结果",
    "check_task_uri" : "v90800010s20eia5",
    "case_uri" : "v90200010s1h66bp",
    "case_name" : "样例功能用例",
    "case_number" : "008",
    "case_creator" : "a17801c5d15f46e28112eec8a880683d",
    "severity_name" : "严重",
    "violation_type" : "预期结果问题",
    "violation_cause" : "违反规则7.1.1,测试步骤1预期结果为空",
    "field_name" : "预期结果",
    "rule_link" : "",
    "rule_description" : "规则7.1.1 测试步骤、预期结果为必填项。",
    "violation_content" : "{\"content\":\"\",\"num\":1}"
  }, {
    "uri" : "v90800010s20eif4",
    "severity" : 3,
    "status" : 1,
    "suggestions" : "请编写测试步骤1描述",
    "check_task_uri" : "v90800010s20eia5",
    "case_uri" : "v90200010s1h65ik",
    "case_name" : "样例接口用例",
    "case_number" : "10010",
    "case_creator" : "a17801c5d15f46e28112eec8a880683d",
    "severity_name" : "严重",
    "violation_type" : "步骤描述问题",
    "violation_cause" : "违反规则7.1.1,测试步骤1描述为空",
    "field_name" : "步骤描述",
    "rule_link" : "",
    "rule_description" : "规则7.1.1 测试步骤、预期结果为必填项。",
    "violation_content" : "{\"content\":\"\",\"num\":1}"
  }, {
    "uri" : "v90810s20eif4dbc",
    "severity" : 3,
    "status" : 0,
    "suggestions" : "请编写测试步骤1预期结果",
    "check_task_uri" : "v90800010s20eia5",
    "case_uri" : "v90200010s1h65ik",
    "case_name" : "样例接口用例",
    "case_number" : "10010",
    "case_creator" : "a17801c5d15f46e28112eec8a880683d",
    "severity_name" : "严重",
    "violation_type" : "预期结果问题",
    "violation_cause" : "违反规则7.1.1,测试步骤1预期结果为空",
    "field_name" : "预期结果",
    "rule_link" : "",
    "rule_description" : "规则7.1.1 测试步骤、预期结果为必填项。",
    "violation_content" : "{\"content\":\"\",\"num\":1}"
  } ],
  "page_size" : 10,
  "page_no" : 1
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档