华为云用户手册

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 assigned_user AssignedUserInfo object 处理者信息 execute_count Integer 测试用例执行次数 extend_info ExtendInfo object 测试用例扩展信息 name String 测试用例名称 project_id String 软开云项目唯一标识 rank_id String 测试用例等级 result_id String 测试用例执行结果 service_id Integer 注册测试类型服务接口返回的服务id status_id String 测试用例状态 testcase_id String 用例uri,测试用例唯一标识,长度11-34位字符（字母和数字）。 testcase_number String 测试用例编号 表4 ExtendInfo 参数 参数类型 描述 author ExtendAuthorInfo object 创建者信息 defect_list Array of AssignedUserInfo objects 缺陷信息 description String 描述信息 domain AssignedUserInfo object 租户信息 fixed_version AssignedUserInfo object 迭代信息 issue AssignedUserInfo object 需求信息 label_list Array of AssignedUserInfo objects 标签信息 module AssignedUserInfo object 模块信息 preparation String 前置条件 steps Array of ExternalServiceCaseStep objects 测试步骤，数组长度小于10 test_version_id String 测试版本号 updator ExtendAuthorInfo object 更新者信息 表5 AssignedUserInfo 参数 参数类型 描述 id String id信息 name String 名称信息 表6 ExternalServiceCaseStep 参数 参数类型 描述 expect_result String 测试用例预期结果信息，长度为[0-500]位字符 test_step String 测试步骤描述信息，长度为[0-500]位字符 表7 ExtendAuthorInfo 参数 参数类型 描述 id String id信息 name String 名称信息 time String 时间信息 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 401 表9 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 404 表10 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 500 表11 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息

URI GET /v1/projects/{project_id}/testcases/{testcase_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释: 项目id，对应"需求管理 CodeArts Req"项目唯一标识，测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值 约束限制: 不涉及 取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 默认取值: 不涉及 testcase_id 是 String 参数解释: 用例uri,测试用例唯一标识，测试用例详情页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testcase?branch_id={branch_id}&case_id={case_id}&detail=base中case_id变量的值 约束限制: 不涉及 取值范围: 长度11-34位字符（字母和数字） 默认取值: 不涉及

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 uri String 资源URI type String 资源类型 author String 创建人 name String 名称 rank Integer 级别 version String 待测版本 owner String 处理者ID creator String 创建人ID iterations String 关联迭代 description String 描述 region String 区域 last_modifier String 最后修改人 last_modified String 最后修改时间 last_modified_timestamp Long 修改时间时间戳 last_change_time String 最后变更时间 version_uri String 版本URI origin_uri String 源资源URI parent_uri String 父资源URI parent_path String 父资源路径 creation_version_uri String 创建版本URI creation_date String 创建时间 creation_date_timestamp Long 创建时间时间戳 author_name String 创建人名称 comment String 备注 number String 编号 is_master Integer 是否为Master分支 is_iterator Integer 是否为迭代 plan_start_date String 开始时间 plan_end_date String 结束时间 service_id String 微服务ID service_name String 微服务名 pbi_id String PBI ID pbi_name String PBI信息 plan_id String 计划ID metric_pbi_ids String 度量PBI ID metric_pbi_id_names String 度量PBI名称 last_syn_date String 最后同步时间 is_closed String 版本是否关闭 asyn_git String 是否同步git库 schema_no Integer schema编号 finish_date String 迭代实际完成时间 owner_name String 处理者名称 creator_name String 创建人名称 current_stage String 当前所处阶段 service_types String 服务类型 risk_rating Integer 风险等级 risk_des String 风险描述 project_uuid String 项目ID domain_id String 租户ID pi_id String pi的id 状态码： 400 表5 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 401 表6 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 404 表7 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 500 表8 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容

API概览 表1 测试计划接口说明 分类 接口 接口测试套管理 通过导入仓库中的文件生成接口测试套 环境参数分组管理 获取环境参数分组列表 测试计划管理 计划中批量添加测试用例 项目下创建计划 项目下查询测试计划列表 查询某个测试计划下的需求树 查询某测试计划下的操作历史 项目下查询测试计划列表v2 获取分支列表 查询项目下所有迭代计划 查询需求树 查询缺陷相关联测试计划 获取分支详情 新增迭代 查询迭代计划列表，包含统计信息 查询迭代关联的需求列表或树 从迭代中移除需求 查询迭代计划详情，包含统计信息 修改测试计划 查询当前租户可见的第三方服务列表 自定义测试服务用例管理 批量执行测试用例 批量更新测试用例结果 通过用例编号获取测试用例详情 创建自定义测试服务类型用例 批量删除自定义测试服务类型用例 获取测试用例详情 更新自定义测试服务类型用例 查询用例修改历史记录 查询用例列表 获取资源池列表 查询附件列表 获取测试报告的模板设置 获取租户订单已用资源信息 获取异步进度 获取项目测试用例自定义字段列表 查询限时免费用户免责声明记录 获取测试类型列表 查询用例详情 生成资源URI 根据domainId获取加密的testbirdkey 查询用户免责声明 查询项目字段配置 获取目录 获取分支列表 新增分支 获取租户订单信息 获取责任人是自己的测试用例 查询用例列表 版本测试用例变更统计（只统计分支，不统计基线） 向迭代中添加资源 从迭代中批量移除用例 保存单个自定义报表 批量删除用例 在分支或者测试计划下修改用例 在分支或者测试计划下创建用例 批量更新用例属性 查询用例评论 新增用例评论 修改用例评论 删除用例评论 拨测告警信息管理 查询任务告警信息 查询告警组列表 查询告警组用户名是否重复 查询告警模板 查询告警模板名称是否重复 接口测试套餐信息查询 接口测试计费信息查询 接口测试获取套餐用量信息 测试报表管理 实时计算单个自定义报表 查询时段内用例的执行情况 查询用户用例关联缺陷的统计信息 查询质量报告看板统计信息 页面报表展示 质量报告需求测试情况统计 根据测试报告uri列表，删除测试报告 测试设计接口管理 根据入参动态查询系统配置中的信息 根据条件分页获取脑图对象 获取脑图创建人 检查项目权限 根据条件分页获取模板V3 根据条件分页获取评审对象V2 根据条件分页获取测试点对象V2 根据条件分页获取场景对象V2 根据条件分页获取测试用例对象V2 根据id获取脑图对象 根据脑图id查询统计数目 获取资产列表 获取资产树列表 根据目录查询因子 根据id获取因子 自定义测试服务测试套件管理 查询用例关联的测试任务列表 查询测试任务列表 获取测试套关联用例详情 拨测仪表盘信息管理 仪表盘根据测试服务ID获取MsgInfo详细信息 查询告警统计数据 查询运行面板信息 查询仪表盘折线图数据 查询仪表盘散点图数据 查询subTestCase阻塞任务数据 查询仪表盘用户的看板 接口测试管理 自定义测试服务接入管理 获取用例历史执行数据 批量获取用例状态 执行用例调度任务接口 查询用户DNS映射 更新用户DNS映射 查询全局变量参数列表V4 根据id获取单个basicAW信息 修改关键字信息接口 融合版本删除单个basicAw 获取工程关联的公共aw信息和公共aw所属公共aw库信息 获取当前局点功能是否开启 分页获取工程BasicAW详细信息列表（含目录） 获取用例脚本详细信息 更新tmss用例和用例脚本 新增用户自定义URL关键字 获取用例历史执行数据 批量获取用例状态 用户获取自己当前已经注册的服务 新测试类型服务注册 更新已注册服务 删除已注册服务 获取特性树V5 拨测任务配置管理 保存任务配置 查询任务配置 测试服务关联关系 添加一个用例和多个需求/缺陷关联关系 删除一个用例和多个需求/缺陷关联关系 添加需求/缺陷和多个用例关联关系 查询需求下的用例列表 拨测套餐状态查询 查询租户在线拨测套餐状态 查询租户测试并发套餐状态 用例关联关系管理 查询项目下关联了需求的用例列表

响应示例 状态码： 201 OK [ { "creator" : { "id" : "efdb403066474ab08836b9eeaaa23bca", "nick_name" : "测试Tester", "user_name" : "测试Tester" }, "current_stage" : "design", "design_stage" : { "case_count" : 2, "issue_count" : 0, "issue_covered_count" : "0" }, "end_date" : "2021-07-10", "execute_stage" : { "case_pass_rate" : "0.00%", "completed_defect_count" : 0, "defect_count" : 0, "executed_case_count" : 0 }, "expire_day" : -4, "finish_date" : "2021-07-10", "iteration" : { "id" : "ID", "name" : "名称" }, "name" : "测试", "owner" : { "id" : "efdb403066474ab08836b9eeaaa23bca", "name" : "测试Tester", "nick_name" : "测试Tester", "user_name" : "测试Tester" }, "plan_id" : "c7c2ddf2ea914164ac6ee76bf11a30ea", "project_id" : "9b26f58ec29943f681804a6628779a23", "report_stage" : { "case_complete_rate" : "100.00%" }, "start_date" : "2021-07-10" } ]

响应参数 状态码： 201 表4 响应Body参数 参数 参数类型 描述 [数组元素] Array of TestPlanDetail objects 项目下查询测试计划列表返回结构 表5 TestPlanDetail 参数 参数类型 描述 creator creator object 测试计划创建者信息 current_stage String 当前测试计划所处的阶段 design_stage design_stage object 测试计划设计阶段信息 end_date String 测试计划截止时间 execute_stage execute_stage object 测试计划执行阶段信息 expire_day Integer 获取超期时间,正值表示已超期 finish_date String 测试计划实际完成时间（测试计划实际完成指测试计划下所有测试用例处于完成状态） iteration NameAndId object 测试计划迭代编号与迭代名称 name String 测试计划名称 owner owner object 测试计划处理者信息 plan_id String 测试计划id project_id String 项目id report_stage report_stage object 报告阶统计数据 start_date String 测试计划开始时间 表6 creator 参数 参数类型 描述 id String 测试计划创建者id nick_name String 测试计划创建者的昵称，当用户未设置昵称时不返回该字段 user_name String 测试计划创建者的用户名称 表7 design_stage 参数 参数类型 描述 case_count Integer 用例个数 issue_count Integer 需求个数 issue_covered_count String 已被用例关联的需求个数 表8 execute_stage 参数 参数类型 描述 case_pass_rate String 用例通过率,按用例结果计算 completed_defect_count Integer 已完成缺陷个数 defect_count Integer 缺陷个数 executed_case_count Integer 已执行用例数, 按用例状态统计 表9 NameAndId 参数 参数类型 描述 id String 对象编号 name String 对象名称 表10 owner 参数 参数类型 描述 id String 测试计划处理者id name String 测试计划处理者名称，优先返回nickName，不存在则返回userName nick_name String 测试计划处理者的昵称，当用户未设置昵称时不返回该字段 user_name String 测试计划处理者的用户名称 表11 report_stage 参数 参数类型 描述 case_complete_rate String 用例完成率,按状态统计 状态码： 400 表12 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 401 表13 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 404 表14 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 500 表15 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息

URI GET /v1/projects/{project_id}/plans 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id，项目唯一标识，固定长度32位字符，获取方式请参见获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 name 否 String 模糊查询使用(针对测试计划名称) current_stage 否 String 测试计划所处阶段（create,design,execute,report） offset 是 Integer 偏移量，取值范围为0-2000000 limit 是 Integer 每页显示的条目数量，取值范围为1-100

URI GET /v1/{project_id}/api-testcases/{testcase_id}/execute-histories 表1 路径参数 参数 是否必选 参数类型 描述 testcase_id 是 String 测试用例id project_id 是 String CodeArts的项目ID 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 起始偏移量，表示从此偏移量开始查询， offset大于等于1 limit 否 Integer 每页显示的条目数量,最大支持200条 plan_id 否 String 测试计划id

响应示例 状态码： 200 OK { "testcase_results" : [ { "execute_result_id" : "6", "execute_status" : "Complete", "failure_cause" : "用例阻塞", "task_id" : "ff4893796ee1a8aa009ff3a470de55d8", "plan_id" : "ff4893796ee1a8aa009ff3a470de5asd", "start_time" : "2023-07-11 10:50:35 528", "executor_id" : "10c0ad654afd48bb9bdc23b459", "executor_name" : "mike", "end_time" : "2023-07-11 10:50:35 528" } ], "project_id" : "10c0ad654afd48bb9bdc23b4594b1a34", "testcase_id" : "v9050000uoeliufsa", "testcase_name" : "测试用例名称", "total_count" : 10 }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total_count Integer 测试用例总数 project_id String 测试服务id testcase_id String 测试用例id testcase_name String 测试用例名称 testcase_results Array of TestcaseResult objects 测试用例结果集 表5 TestcaseResult 参数 参数类型 描述 execute_result_id String 结果 execute_status String 测试用例状态 failure_cause String 失败原因 task_id String 任务id plan_id String 测试计划id start_time String 开始时间 end_time String 结束时间 executor_id String 执行测试用例用户id executor_name String 执行测试用例用户name 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 403 表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 接口调用失败错误信息

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 alert_success_rate Integer 告警成功比率，恒为1 running_tasks Integer 正在运行的任务个数 total_alerts Integer 总告警数 total_days Integer 总运行天数 total_runs Long 总运行个数 total_tasks Integer 总任务个数 work_item_count Integer 工作项个数 状态码： 401 表4 响应Body参数 参数 参数类型 描述 error_code String 错误编码 error_msg String 错误原因 状态码： 403 表5 响应Body参数 参数 参数类型 描述 error_code String 错误编码 error_msg String 错误原因 状态码： 404 表6 响应Body参数 参数 参数类型 描述 error_code String 错误编码 error_msg String 错误原因

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String token 表3 请求Body参数 参数 是否必选 参数类型 描述 alert_types 否 Array of strings 告警类型 case_id 否 String 用例id case_name 否 String 用例名 end_time 否 Long 结束时间 page_num 否 Integer 页码 page_size 否 Integer 分页大小 send_alert_type 否 String 发送类型 start_time 否 Long 开始时间 task_id 否 String 任务id task_name 否 String 任务名

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 list Array of MsgInfoVo objects 返回结果 page_num Integer 页码 page_size Integer 分页大小 total_page Integer 总页数 total_size Long 总条数 表5 MsgInfoVo 参数 参数类型 描述 alert_channels String 告警渠道 alert_groups String 告警分组 alert_level Integer 告警级别 alert_num Integer 总告警次数 alert_time String 告警时间 alert_type String 告警类型 content String 告警内容 id String MsgInfo的id link String 链接 location_names String 执行机区域 send_alert_type String 发送告警类型 sub_task_case_id String 子任务用例id sub_task_case_start_time String 子任务用例开始时间 sub_task_id String 子任务id sub_task_start_time String 子任务开始时间 task_id String 任务id task_name String 任务名 test_case_id String 用例id test_case_name String 用例名称 test_suite_type Integer 测试套类型 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误编码 error_msg String 错误原因 状态码： 403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误编码 error_msg String 错误原因 状态码： 404 表8 响应Body参数 参数 参数类型 描述 error_code String 错误编码 error_msg String 错误原因

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 related_case_uris Array of strings 关联的用例uris not_related_case_uris Array of strings 未关联的用例uris case_task_info Array of RelateTaskTestCasesVo objects 用例及任务信息 表5 RelateTaskTestCasesVo 参数 参数类型 描述 test_case_num String 用例编号 test_case_name String 用例名 test_case_uri String 用例uri task_uri String 任务uri task_name String 任务名 task_num String 任务编号 task_creator String 任务创建人 状态码： 400 表6 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 401 表7 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 404 表8 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 500 表9 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 page_no 否 Integer 页码 page_size 否 Integer 每页数量 start_index 否 Integer 起始位 end_index 否 Integer 结束位 key_word 否 String 关键字 test_case_uris 否 Array of strings 用例uri列表 iterator_uri 否 String 测试计划uri

URI POST /GT3KServer/v4/{project_id}/testcases/tasks/batch-query 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释: 项目id，对应"需求管理 CodeArts Req"项目唯一标识，测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值 约束限制: 不涉及 取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 默认取值: 不涉及

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 code String 错误码 data BasePageInfoTemplateV2 object 返回体 message String 错误信息 表6 BasePageInfoTemplateV2 参数 参数类型 描述 limit Integer 每页显示的条目数量，最大支持200条 list Array of TemplateV2 objects 返回体 offset Integer 起始偏移量，表示从此偏移量开始查询，offset大于等于0，小于等于100000 pages Integer 页数 size Integer 记录数 total Long 总数 表7 TemplateV2 参数 参数类型 描述 create_time String 创建时间 creator_name String 创建人名称 creator_num String 创建人工号 description String 描述 id String id 主键 is_default String 是否默认 mindmap String 脑图json name String 名称 update_time String 更新时间 editPermission Boolean 编辑权限 deletePermission Boolean 删除权限 状态码： 400 表8 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息 状态码： 401 表9 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息 状态码： 404 表10 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息 状态码： 500 表11 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 params 否 TemplatePageParam object 模板分页参数 表4 TemplatePageParam 参数 是否必选 参数类型 描述 creator_num 否 String 创建人ID offset 否 Integer 起始偏移量，表示从此偏移量开始查询，offset大于等于0，小于等于100000 limit 否 Integer 每页显示的条目数量，最大支持200条 name 否 String 脑图名称

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value Array of TestCaseListVo objects 实际的数据类型：单个对象，集合 或 NULL reason String 业务失败的提示内容，对内接口才有此值 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表6 TestCaseListVo 参数 参数类型 描述 uri String 用例URI name String 用例名称 owner NameAndIdVo object 服务类型信息 status NameAndIdVo object 服务类型信息 result NameAndIdVo object 服务类型信息 module NameAndIdVo object 服务类型信息 iteration NameAndIdVo object 服务类型信息 exeplatform String 执行平台，如：apittest,其他三方执行平台 number String 用例编号 description String 用例描述 rank_id String 用例等级 feature_uri String 目录URI release_dev String 版本号 is_keyword Boolean 是否组合关键字 script_url String 脚本路径 report_url String 实时报告地址 project_uuid String 项目ID service_type NameAndIdVo object 服务类型信息 test_type IntegerIdAndNameVo object 测试类型信息 create_info CreateInfoVo object 创建信息 execute_info ExecuteInfoVo object 执行信息 associate_issue_info AssociateIssueInfoVo object 关联需求信息 associate_defect_info AssociateDefectInfoVo object 关联缺陷信息 case_type Integer 用例类型 labels String 用例标签名称列表 custom_field_info Array of CustomFieldVo objects 自定义字段信息 is_test_design Boolean 是否来自测试设计（null：不限，false：否来自测试设计，true：来自测试设计） last_modified Long 最后修改时间（null：不限） review_status Integer 用例评审状态（null：0至127） 表7 NameAndIdVo 参数 参数类型 描述 id String ID name String 名称 表8 IntegerIdAndNameVo 参数 参数类型 描述 id Integer 数据库存储数字 name String 页面显示值 表9 CreateInfoVo 参数 参数类型 描述 time String 创建时间 timestamp Long 创建时间时间戳 user_id String 用户ID user_name String 用户名称 表10 ExecuteInfoVo 参数 参数类型 描述 time String 执行开始时间 timestamp Long 执行开始时间时间戳 duration String 执行时长 user_id String 用户ID user_name String 用户名称 execute_times Integer 执行次数 表11 AssociateIssueInfoVo 参数 参数类型 描述 associate Boolean 是否已关联 issue_id String 需求ID tracker_id String 需求类型 board_id String 工作项层级ID tracker_name String 需求类型名称 表12 AssociateDefectInfoVo 参数 参数类型 描述 associate Boolean 是否已关联 associate_count Integer 关联缺陷数 表13 CustomFieldVo 参数 参数类型 描述 type String 字段类型（单行文本text、多行文本textArea、单选框radio、多选框checkBox、日期date、数字number、单选用户user） value String 测试用例自定义字段值 custom_field_param String 项目用例自定义字段入参或者返回参数名称 user_name String user类型测试用例自定义字段对应用户名，其它类型字段不返回 状态码： 400 表14 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 401 表15 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 404 表16 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 500 表17 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 keyword 否 String 关键字查询，用例名或编号 exeplatforms 否 Array of strings 执行平台 own 否 Boolean 是否是我的 useOffset 否 Boolean 是否使用偏移量方式查询 version_uri 否 String 版本URI case_uris 否 Array of strings 用例URI集合 owner_ids 否 Array of strings 处理者ID集合 status_codes 否 Array of strings 状态Code集合 rank_ids 否 Array of strings 用例等级ID集合 module_ids 否 Array of strings 模块ID集合 issue_id 否 String 需求编号 creator_ids 否 Array of strings 创建者ID集合 result_codes 否 Array of strings 结果Code集合 iteration_ids 否 Array of strings 归属迭代ID集合 create_start_time 否 String 创建开始时间 create_end_time 否 String 创建结束时间 associated_issue 否 Boolean 是否关联需求（null：不限，false：未关联，true：已关联） associated_defects 否 Boolean 是否关联缺陷（null：不限，false：未关联，true：已关联） include_sub_issue 否 Boolean 是否查询子需求关联的用例，默认true include_sub_feature 否 Boolean 是否查询子目录的用例，默认true label_ids 否 Array of strings 标签ID集合 execute_start_time 否 String 执行开始时间 execute_end_time 否 String 执行结束时间 executor_ids 否 Array of strings 执行者ID集合 test_types 否 Array of strings 类型 is_keyword 否 Boolean 是否组合关键字 issue_tree_search 否 Boolean 是否是需求树点击的查询关联用例 service_type 否 Integer 服务类型 service_types 否 Array of integers 服务类型集合 stage_type 否 Integer 阶段过程（2：测试设计，3：测试执行，4：质量报告） feature_uri 否 String 目录URI sort_field 否 String 排序字段 sort_type 否 String 排序方式 page_no 否 Integer 当前页数 page_size 否 Integer 每页条数 case_type 否 Integer 用例类型 custom_field_info 否 Array of QueryCustomFieldsInfo objects 用例自定义字段信息 task_uri 否 String 测试套uri associate_issue_detail 否 Boolean 是否返回需求具体信息（返回需求名称，需求id） not_assign_task 否 Boolean 该字段为false,则查询全量用例，为true表示查询未分配测试套的用例 test_designs 否 Array of booleans 是否来自测试设计（null或者[true, false]：不限，[true]：来自测试设计，[false]：否来自测试设计） review_status 否 Integer 用例评审状态 表4 QueryCustomFieldsInfo 参数 是否必选 参数类型 描述 id 否 Integer 测试用例自定义字段Id values 否 Array of strings 测试用例自定义字段值 field_name 否 String 自定义字段名，优先取id再取fieldName

URI POST /GT3KServer/v4/{project_id}/testcases/batch-query 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释: 项目id，对应"需求管理 CodeArts Req"项目唯一标识，测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值 约束限制: 不涉及 取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 默认取值: 不涉及

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 - String - 状态码： 401 表5 响应Body参数 参数 参数类型 描述 error_code String 错误编码 error_msg String 错误原因 状态码： 403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误编码 error_msg String 错误原因 状态码： 404 表7 响应Body参数 参数 参数类型 描述 error_code String 错误编码 error_msg String 错误原因

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 对外时：success|error; result ResultValueStringForOk object 请求结果 表4 ResultValueStringForOk 参数 参数类型 描述 value String ok 状态码： 400 表5 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 401 表6 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 404 表7 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 500 表8 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 code String 错误码 error CommonResponseErrorString object 统一错误返回 reason String 失败原因 result String 结果 status String 状态 表4 CommonResponseErrorString 参数 参数类型 描述 code String 错误码 reason String 错误原因

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 code String 错误码 error CommonResponseErrorOfAPITest object 统一错误返回 reason String 失败原因 result BasicAwRes object 结果 status String 状态 表4 CommonResponseErrorOfAPITest 参数 参数类型 描述 code String 错误码 reason String 错误原因 表5 BasicAwRes 参数 参数类型 描述 aw_code String 关键字代码, hascode字段为1是有效 aw_description String 模板描述 aw_mark Integer 关键字标记 aw_operationid String 关键字操作编号 aw_tags String 关键字tags aw_type Integer 关键字类型 aw_uniqueid String 关键字来源编号 by_order Integer 关键字顺序 create_time String 创建时间 create_time_stamp Long 创建时间戳 create_time_string String 创建时间戳 create_user String 创建人 create_user_id String 创建人ID delete_time String 更新时间 delete_user String 删除人 description String 描述 dft_check_point_list Array of objects 默认检查点列表 dft_custom_header Array of objects 默认请求头参数对象 dft_retry_interval String 重试间隔时间 (ms) 为空表示不等待 dft_retry_times String 重试次数 dft_variable_list Array of objects 默认变量信息 extra_info Object 补充信息 group_name String 分组名 has_code Integer 是否存在代码 id String 编号 import_package Array of strings 导入的包名 interface_label String 接口的x-extend字段说明 is_favorite Integer 是否收藏 method String 方法名 name String 关键字名 nameView String 在页面上显示的名字 origin_project String 源工程信息 param_type_and_dft_value Array of objects 参数类型和参数默认值 project_id String 工程编号 protocol_type String 协议类型 public_aw_lib Object 公共关键字信息 public_aw_lib_id String 公共关键字id region String region信息 return_type String 返回值类型 root_id String 根节点编号 source String 关键字依赖的类源 special_type Integer 特殊关键字类型 tmssCaseNumber String 关键字编号（来自测试管理服务） tmss_case_id String 测试用例id update_time String 更新时间 update_time_stamp Long 更新时间戳 update_time_string String 更新时间戳（字符串格式） update_user String 更新人 warningMsg String 警告信息 yamlName String yaml名称

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 status String 对外时：success|error; result ResultValueStringForOk object 请求结果 表5 ResultValueStringForOk 参数 参数类型 描述 value String ok 状态码： 400 表6 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 401 表7 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 404 表8 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 500 表9 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 work_item_ids 否 Array of strings 需求/缺陷ID列表 project_uuid 否 String 项目id version_uri 否 String 版本uri relate_type 否 String 关联关系类型

URI POST /GT3KServer/v4/{project_id}/versions/{version_id}/custom-reports 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释: 项目id，对应"需求管理 CodeArts Req"项目唯一标识，测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值 约束限制: 不涉及 取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 默认取值: 不涉及 version_id 是 String 版本uri

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 name 否 String 报表名称 type 否 Integer 报表类型 1：首页用例库， 2：质量报告 workpiece_type 否 String 工件类型(用例：case,测试套：suite) analysis_dim_row 否 String 分析维度 compare_dim_column 否 String 对比维度 filter 否 ReportFilter object 过滤条件 表4 ReportFilter 参数 是否必选 参数类型 描述 creatorIds 否 String 创建人 ownerIds 否 String 所属人 ranks 否 String 级别 releaseIds 否 String releaseId status 否 String 状态 moduleIds 否 String 级别 results 否 String 结果 labelIds 否 String 标签 startTime 否 String 开始时间 endTime 否 String 结束时间 isAssociateIssue 否 String 是否关联需求

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 value String testbird key 状态码： 400 表6 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 401 表7 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 404 表8 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 500 表9 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容