华为云用户手册

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 status String success|error result ResultValueIteratorStageSummaryVo object 请求的返回的数据对象 error ApiError object 失败时的error信息 request_id String 由接口调用方传入，建议使用UUID保证请求的唯一性。 server_address String 本次请求的受理的服务地址。 表6 ResultValueIteratorStageSummaryVo 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value IteratorStageSummaryVo object 实际的数据类型：单个对象，集合 或 NULL reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表7 IteratorStageSummaryVo 参数 参数类型 描述 create_count Integer 新建状态数量 design_count Integer 设计状态数量 execute_count Integer 执行状态数量 report_count Integer 报告状态数量 total_count Integer 迭代计划总数 表8 ApiError 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 400 表9 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 401 表10 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 404 表11 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 500 表12 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息

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

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String success|error result ResultValueListProjectFieldConfigVo object 请求的返回的数据对象 error ApiError object 失败时的error信息 request_id String 由接口调用方传入，建议使用UUID保证请求的唯一性。 server_address String 本次请求的受理的服务地址。 表4 ResultValueListProjectFieldConfigVo 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value Array of ProjectFieldConfigVo objects 实际的数据类型：单个对象，集合 或 NULL reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表5 ProjectFieldConfigVo 参数 参数类型 描述 uri String 字段配置URI标识 updator NameAndIdVo object 服务类型信息 description String 描述 customName String 项目用例自定义字段名称 table_field_name String 字段名（对应后端参数名） value_type String 字段类型(单行文本text、多行文本textArea、单选框radio、多选框checkbox、日期date、数字number、用户user)。 value_type_name String 字段类型国际化名称 is_system Integer 是否系统字段 is_display Integer 是否显示 is_required Integer 是否必填 sort_numb Integer 顺序数值 default_value String 默认值 custom_field_uri String 扩展字段uri(用于连表查扩展字段) resource_type String 资源类型 creator NameAndIdVo object 服务类型信息 create_time_stamp Long 创建时间时间戳 update_time_stamp Long 更新时间时间戳 project_uuid String 项目ID option_vos Array of ProjectFieldConfigOptionVo objects 可选项 custom_field_id Integer 项目用例自定义字段id（1-25数字） custom_field_name String 项目用例自定义字段名称 custom_field_param String 项目用例自定义字段入参或者返回参数名称 表6 ProjectFieldConfigOptionVo 参数 参数类型 描述 uri String 字段选项URI标识.新增不传，修改、删除使用必传 name String 可选项名称 code String 可选项code值 updator NameAndIdVo object 服务类型信息 description String 描述 flag Integer 修改标识，0：不可修改 1：可修改，用于结果和状态的选项值 sort_numb Integer 顺序数值 creator NameAndIdVo object 服务类型信息 create_time_stamp Long 创建时间时间戳 update_time_stamp Long 更新时间时间戳 表7 NameAndIdVo 参数 参数类型 描述 id String ID name String 名称 表8 ApiError 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 400 表9 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 401 表10 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 404 表11 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 500 表12 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容

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

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 status String success|error; result ResultValueRequirementsOverviewVo object 请求的返回的数据对象 error ApiError object 失败时的error信息 表7 ResultValueRequirementsOverviewVo 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value RequirementsOverviewVo object 实际的数据类型：单个对象，集合 或 NULL reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表8 RequirementsOverviewVo 参数 参数类型 描述 total_number Integer 质量报告需求测试情况总数 requirement_overview_list Array of RequirementOverviewVo objects 质量报告需求测试情况列表 表9 RequirementOverviewVo 参数 参数类型 描述 name String 需求名称 workitem_id String 需求id sequence_id String 需求序列编号 board_id String 看板需求id tracker_id String 需求类型id tracker_name String 需求类型 relate_case_number Integer 需求关联用例总数 case_pass_vo CasePassVo object 需求关联用例通过情况 case_execute_vo CaseExecuteVo object 需求关联用例执行率情况 relate_defect_number Integer 需求关联缺陷总数 表10 CasePassVo 参数 参数类型 描述 pass_rate String 需求关联用例通过率 result_number_list Array of NameAndValueVo objects 需求关联用例结果与对应的用例数目列表 表11 NameAndValueVo 参数 参数类型 描述 name String 名称 value Integer 值 表12 CaseExecuteVo 参数 参数类型 描述 execute_rate String 需求关联用例执行率 executed_number Integer 需求关联已执行用例总数 not_executed_number Integer 需求关联未执行用例总数 表13 ApiError 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 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 业务失败的提示内容

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

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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 comment 是 String 评论 notifier 否 Array of strings 通知人列表 version_uri 否 String 分支uri/测试计划uri

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 uri String URI creator String 创建者 comment String 评论内容 notifier Array of strings 评论通知人 test_case_uri String 测试用例URI create_time String 创建时间 create_time_timestamp Long 创建时间时间戳 update_time String 更新时间 update_time_timestamp Long 更新时间时间戳 project_uuid String 项目UUID version_uri String 版本/测试计划URI display_name String 是否显示通知人 状态码： 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 表2 响应Body参数 参数 参数类型 描述 status String success|error result ResultValueAccessInfoVo object 请求的返回的数据对象 error ApiError object 失败时的error信息 request_id String 由接口调用方传入，建议使用UUID保证请求的唯一性。 server_address String 本次请求的受理的服务地址 表3 ResultValueAccessInfoVo 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value AccessInfoVo object 实际的数据类型：单个对象，集合 或 NULL reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表4 AccessInfoVo 参数 参数类型 描述 message String 租户服务开通提示信息 domain_order_status String 租户订单状态 has_free_quota Boolean 是否有免费配额 表5 ApiError 参数 参数类型 描述 code String 业务失败的错误码 reason 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 接口调用失败错误信息

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 code String 错误码 data MindmapObject object 返回体 message String 错误信息 表4 MindmapObject 参数 参数类型 描述 create_time String 创建时间 creator_name String 创建人名称 creator_num String 创建人工号 folder_id String 文件路径 folder_root_id String 根目录id id String id 主键 max_depth Integer 脑图最大深度 mindmap String 脑图JSON name String 脑图名称 project_id String 项目id update_time String 更新时间 状态码： 400 表5 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息 状态码： 401 表6 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息 状态码： 404 表7 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息 状态码： 500 表8 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息

请求示例 实时计算单个自定义报表 post https://{endpoint}/v4/projects/efdb403066474ab08836b9eeaaa23bca/versions/daiuyd9tqdxas/custom-reports/generate { "name" : "name", "workpiece_type" : "case", "analysis_dim_row" : "name", "compare_dim_column" : "name", "filter" : { "creatorIds" : "1445148", "ownerIds" : "1445148", "ranks" : "1", "releaseIds" : "1", "status" : "1", "moduleIds" : "1", "results" : "1", "labelIds" : "1", "startTime" : "2020-09-08 10:42:07", "endTime" : "2020-09-08 10:42:07", "isAssociateIssue" : "true" } }

响应示例 状态码： 200 OK { "status" : "string", "result" : { "total" : 0, "value" : { "id" : "1", "name" : "报表名称", "filter" : { "creatorIds" : "1445148", "ownerIds" : "1445148", "ranks" : "1", "releaseIds" : "1", "status" : "1", "moduleIds" : "1", "results" : "1", "labelIds" : "1", "startTime" : "2020-09-08 10:42:07", "endTime" : "2020-09-08 10:42:07", "isAssociateIssue" : "true" }, "workpiece_type" : "case", "analysis_dimension" : "AUTHOR", "compare_dimension" : "AUTHOR", "chart_data" : [ { "id" : "1", "name" : "报表名称", "analyze_dim" : { "id" : "1", "name" : "名称", "value" : 0 }, "compare_dim" : [ { "id" : "1", "name" : "名称", "value" : 0 } ] } ] }, "reason" : "string", "page_size" : 0, "page_no" : 0, "has_more" : true }, "error" : { "code" : "string", "reason" : "string" }, "request_id" : "string" }

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 status String success|error result ResultValueCustomReportListVo object 请求的返回的数据对象 error ApiError object 失败时的error信息 request_id String 由接口调用方传入，建议使用UUID保证请求的唯一性。 表6 ResultValueCustomReportListVo 参数 参数类型 描述 total Integer 起始记录数大于实际总条数时，值为0，分页请求才有此值 value CustomReportListVo object 实际的数据类型：单个对象，集合 或 NULL reason String 业务失败的提示内容，对内接口才有此值 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表7 CustomReportListVo 参数 参数类型 描述 id String 报表id name String 报表名称 filter ReportFilter object 过滤条件 workpiece_type String 工件类型(用例：case,测试套：task) analysis_dimension String 分析维度 compare_dimension String 对比维度 chart_data Array of ReportChartDataVo objects 报表数据 表8 ReportFilter 参数 参数类型 描述 creatorIds String 参数解释: 自定义报表创建人用户ID，指定由对应用户创建的用例或测试套进行报表生成 约束限制: 不涉及 取值范围: 长度为1-1000字符（字母或数字）,可选择多个用户ID，用逗号拼接 默认取值: 不涉及 ownerIds String 参数解释: 自定义报表所属人用户ID，指定由对应用户作为Owner的用例或测试套进行报表生成 约束限制: 不涉及 取值范围: 长度为1-1000字符（字母或数字）,可选择多个用户ID，用逗号拼接 默认取值: 不涉及 ranks String 参数解释: 测试用例级别，指定对应用例级别的用例进行报表生成 约束限制: 不涉及 取值范围: 级别为数字, 可选择多个用例级别，用逗号拼接 默认取值: 不涉及 releaseIds String 参数解释: 需求管理中迭代计划的ID，指定关联了对应迭代的用例进行报表生成 约束限制: 不涉及 取值范围: 长度为1-1000字符（字母或数字），可选择多个迭代ID，用逗号拼接 默认取值: 不涉及 status String 参数解释: 测试用例状态ID, 指定对应用例状态下的用例进行报表生成 约束限制: 不涉及 取值范围: 长度为1-255字符（数字），可选择多个状态ID，用逗号拼接 默认取值: 不涉及 moduleIds String 参数解释: 需求管理中定义的模块ID，指定关联了对应模块的用例进行报表生成 约束限制: 不涉及 取值范围: 长度为1-1000字符（字母或数字），可选择多个模块，用逗号拼接 默认取值: 不涉及 results String 参数解释: 测试用例结果的状态编码，指定对应用例结果的用例进行报表生成 约束限制: 不涉及 取值范围: 长度为1-255字符（数字），可选择多个结果ID，用逗号拼接 默认取值: 不涉及 labelIds String 参数解释: 测试用例关联的标签ID，指定对应关联了该标签的用例进行报表生成 约束限制: 不涉及 取值范围: 长度为1-1000字符（字母或数字），可选择多个标签，用逗号拼接 默认取值: 不涉及 startTime String 参数解释: 开始时间，指定创建时间在该时间之后的用例进行报表生成 约束限制: 与结束时间配合，过滤在指定范围内的用例 取值范围: 日期时间格式为yyyy-MM-dd hh:mm:ss，如：2020-09-08 10:42:07 默认取值: 不涉及 endTime String 参数解释: 结束时间，指定创建时间在该时间之前的用例进行报表生成 约束限制: 与开始时间配合，过滤在指定范围内的用例 取值范围: 日期时间格式为yyyy-MM-dd hh:mm:ss，如：2020-09-08 10:42:07 默认取值: 不涉及 isAssociateIssue String 参数解释: 是否关联需求，指定已关联需求或未关联需求的用例进行报表生成 约束限制: 不涉及 取值范围: true或false 默认取值: 不涉及 表9 ReportChartDataVo 参数 参数类型 描述 id String 报表id name String 报表名称 analyze_dim ReportDimVo object 对比维度数据 compare_dim Array of ReportDimVo objects 对比维度数据 表10 ReportDimVo 参数 参数类型 描述 id String id name String 名称 value Integer 值 表11 ApiError 参数 参数类型 描述 code String 只有对外的接口才会返回此内容 reason 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 接口调用失败错误信息

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 name 否 String 参数解释: 自定义报表的名称，由用户定义，用于表示当前创建的自定义报表 约束限制: 不涉及 取值范围: 长度为3-128字符（中文或字母） 默认取值: 不涉及 workpiece_type 否 String 参数解释: 工件类型(用例：case,测试套：task) 约束限制: 不涉及 取值范围: case/task 默认取值: 不涉及 analysis_dim_row 否 String 参数解释: 分析维度,为自定义报表X轴 约束限制: 不涉及 取值范围: 取值需为:CREATORID(创建人),OWNERID(处理人),RANK(级别),RELEASEID(迭代),STATUS(状态),MODULEID(模块),RELEASEDEV(版本号),RESULT(结果),EXECUTOR(执行人),ASSOCIATEISSUE(关联工作项),ASSOCIATEDEFECT(关联缺陷),EXECUTETIMES(执行次数) 默认取值: 不涉及 compare_dim_column 否 String 参数解释: 对比维度,为自定义报表Y轴 约束限制: 需结合分析维度进行用例/测试套统计 取值范围: 取值需为(必填):CREATORID(创建人),OWNERID(处理人),RANK(级别),RELEASEID(迭代),STATUS(状态),MODULEID(模块),RELEASEDEV(版本号),RESULT(结果),EXECUTOR(执行人),ASSOCIATEISSUE(关联工作项),ASSOCIATEDEFECT(关联缺陷) 默认取值: 不涉及 filter 否 ReportFilter object 过滤条件 表4 ReportFilter 参数 是否必选 参数类型 描述 creatorIds 否 String 参数解释: 自定义报表创建人用户ID，指定由对应用户创建的用例或测试套进行报表生成 约束限制: 不涉及 取值范围: 长度为1-1000字符（字母或数字）,可选择多个用户ID，用逗号拼接 默认取值: 不涉及 ownerIds 否 String 参数解释: 自定义报表所属人用户ID，指定由对应用户作为Owner的用例或测试套进行报表生成 约束限制: 不涉及 取值范围: 长度为1-1000字符（字母或数字）,可选择多个用户ID，用逗号拼接 默认取值: 不涉及 ranks 否 String 参数解释: 测试用例级别，指定对应用例级别的用例进行报表生成 约束限制: 不涉及 取值范围: 级别为数字, 可选择多个用例级别，用逗号拼接 默认取值: 不涉及 releaseIds 否 String 参数解释: 需求管理中迭代计划的ID，指定关联了对应迭代的用例进行报表生成 约束限制: 不涉及 取值范围: 长度为1-1000字符（字母或数字），可选择多个迭代ID，用逗号拼接 默认取值: 不涉及 status 否 String 参数解释: 测试用例状态ID, 指定对应用例状态下的用例进行报表生成 约束限制: 不涉及 取值范围: 长度为1-255字符（数字），可选择多个状态ID，用逗号拼接 默认取值: 不涉及 moduleIds 否 String 参数解释: 需求管理中定义的模块ID，指定关联了对应模块的用例进行报表生成 约束限制: 不涉及 取值范围: 长度为1-1000字符（字母或数字），可选择多个模块，用逗号拼接 默认取值: 不涉及 results 否 String 参数解释: 测试用例结果的状态编码，指定对应用例结果的用例进行报表生成 约束限制: 不涉及 取值范围: 长度为1-255字符（数字），可选择多个结果ID，用逗号拼接 默认取值: 不涉及 labelIds 否 String 参数解释: 测试用例关联的标签ID，指定对应关联了该标签的用例进行报表生成 约束限制: 不涉及 取值范围: 长度为1-1000字符（字母或数字），可选择多个标签，用逗号拼接 默认取值: 不涉及 startTime 否 String 参数解释: 开始时间，指定创建时间在该时间之后的用例进行报表生成 约束限制: 与结束时间配合，过滤在指定范围内的用例 取值范围: 日期时间格式为yyyy-MM-dd hh:mm:ss，如：2020-09-08 10:42:07 默认取值: 不涉及 endTime 否 String 参数解释: 结束时间，指定创建时间在该时间之前的用例进行报表生成 约束限制: 与开始时间配合，过滤在指定范围内的用例 取值范围: 日期时间格式为yyyy-MM-dd hh:mm:ss，如：2020-09-08 10:42:07 默认取值: 不涉及 isAssociateIssue 否 String 参数解释: 是否关联需求，指定已关联需求或未关联需求的用例进行报表生成 约束限制: 不涉及 取值范围: true或false 默认取值: 不涉及

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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 cases 否 Array of strings 用例列表 functionType 否 String 执行的功能类型："1"表示执行；"2"表示调试 releaseversion 否 String 发布版本号 resourcePool 否 ResourcePool object 资源池 taskName 否 String 任务名称 表4 ResourcePool 参数 是否必选 参数类型 描述 activeState 否 String 活动状态 id 否 String id name 否 String 名称 selected 否 Boolean 是否被选中 type 否 String 类型

请求示例 { "cases" : [ "v91k0000vqss36au" ], "taskName" : "taskTestSuite2024/8/31 16:0:57", "releaseversion" : "", "resourcePool" : { "activeState" : "ACTIVE", "id" : "DEFAULT", "type" : "DEFAULT" }, "functionType" : "2" }

响应示例 状态码： 200 OK { "status" : "success", "result" : { "taskId" : "b98e483aecba4fe3b00b0fe484c391ca", "needApprove" : null, "warn" : [ ], "packageType" : "codearts.testplan.china.pro", "isPopup" : false }, "error" : null }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 comments String 备注 config_key String 配置键 config_type String 配置类型 config_value String 配置值 create_time String 创建时间 create_user String 创建者 id String UUID test_service_id String 服务id update_time String 修改时间 update_user 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 错误原因

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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String token 表3 请求Body参数 参数 是否必选 参数类型 描述 end_time 否 Long 查询结束时间 page_num 否 Integer 分页参数，页码 page_size 否 Integer 分页参数，每页大小 start_time 否 Long 查询开始时间 task_ids 否 Array of strings 任务Id列表

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 list Array of SubTaskCaseSuccessLineVo objects 返回结果 page_num Integer 页码 page_size Integer 分页大小 total_page Integer 总页数 total_size Long 总条数 表5 SubTaskCaseSuccessLineVo 参数 参数类型 描述 detail Array of SubTaskCaseSuccessLineDetailVo objects 用例成功率统计信息 task_id String 任务id task_name String 任务名称 表6 SubTaskCaseSuccessLineDetailVo 参数 参数类型 描述 date Long 统计时间 pass_rate Float 成功率 task_id String 任务id task_name 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 错误原因

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 code String 错误码 data Object 返回体 message String 错误信息 状态码： 400 表4 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息 状态码： 401 表5 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息 状态码： 404 表6 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息 状态码： 500 表7 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value Array of TestCaseVo objects 实际的数据类型：单个对象，集合 或 NULL reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表4 TestCaseVo 参数 参数类型 描述 uri String 资源URI type String 资源类型 author String 创建人 name String 名称 rank Integer 级别 preparation String 前置条件 remark String 备注 stage String 测试阶段 activity String 测试类型 keywords String 关键词 market String apitest标记是否代码已提交 designer String 设计者 tags String 标签 execute_parameter String 执行参数 region String 逻辑region owner String 处理人id，IteratorTestCase字段 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 编号 case_type Integer 用例类型 platform_type Integer 执行平台类型 service_type Integer 服务类型 service_type_name String 服务类型名称 test_type Integer 测试类型 test_type_name String 测试类型名称 design_note String 设计描述 test_step String 测试步骤 expect_output String 期望结果 env_type String 测试环境类型 exe_platform String 执行平台 testcase_project String 测试工程 svn_script_path String 脚本路径 map_restrict String 约束条件 network_script_name String 网络脚本名 auto_type Integer 自动化类型，非自动化:0, 是自动化:1 to_be_auto_exec Integer 被自动化执行 last_result String 最后一次结果 last_result_uri String 最后一次结果Uri feature_uri String 目录Uri feature_name String 目录名称 interface_name String 测试接口名 snp_no String 网络问题ID dr_relation_id String 关联需求编号 issue_name String 需求名称 test_base_num String 测试基数 automatically_executed Integer 是否被自动化执行 first_execute_time String 第一次执行时间 detect_type String 检测类型 execute_param String 执行参数 test_feature String 分析领域 is_contract_testcase Integer 是否是契约用例，0:表示非契约用例, 1：表示契约用例 time_cost Double 总共耗时 be_auto_type_time String 记录用例由非自动化变为自动化类型的时间 compare_number String 配对用例编号 scene_flag String 场景标识 base_flag String 场景标识 para_validator String 区别是否从yaml中生成的用例，默认false knet_node_id String knet节点id last_exe_author String 最后一次执行用户 cloud_carrier String 运营商 market_place String 应用市场 test_mind_id String 脑图id test_mind_url String 脑图url commit_url String git提交url test_pattern_number String 测试模式编号 test_factor_number String 测试因子编号 status_code String 状态Code result_code String 结果Code release_id String 迭代ID label_id String 标签ID labels String 用例标签名称列表 module_id String 模块ID module_name String 模块名称 module_path String 模块path module_path_name String 模块路径名称 execute_latest_time String 最后执行时间 execute_duration String 执行时长 execute_times Integer 执行次数 is_keyword Integer 是否关键用例 release_dev String 测试版本号 new_created String 是否用户新增用例 project_uuid String 项目ID creation_version_name String 创建版本名称，原逻辑marshall添加字段 feature_path String 特性路径，原逻辑marshall添加字段 testcase_uri String 实体用例Uri，IteratorTestCase字段 owner_name String 处理人名称 iterator_case_uri String 迭代用例Uri，IteratorTestCase字段 script_link String 脚本链接scriptLink custom_field_1 String 自定义字段1 custom_field_2 String 自定义字段2 custom_field_3 String 自定义字段3 custom_field_4 String 自定义字段4 custom_field_5 String 自定义字段5 custom_field_6 String 自定义字段6 custom_field_7 String 自定义字段7 custom_field_8 String 自定义字段8 custom_field_9 String 自定义字段9 custom_field_10 String 自定义字段10 custom_field_11 String 自定义字段11 custom_field_12 String 自定义字段12 custom_field_13 String 自定义字段13 custom_field_14 String 自定义字段14 custom_field_15 String 自定义字段15 custom_field_16 String 自定义字段16 custom_field_17 String 自定义字段17 custom_field_18 String 自定义字段18 custom_field_19 String 自定义字段19 custom_field_20 String 自定义字段20 custom_field_21 String 自定义字段21 custom_field_22 String 自定义字段22 custom_field_23 String 自定义字段23 custom_field_24 String 自定义字段24 custom_field_25 String 自定义字段25 状态码： 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 业务失败的提示内容

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

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 value Array of ProjectTestCaseFieldVo objects 本次查询的记录结果 表4 ProjectTestCaseFieldVo 参数 参数类型 描述 uri String 项目用例自定义字段主键 name String 项目用例自定义字段名称 type String 项目用例自定义字段类型（单行文本text、多行文本textArea、单选框radio、多选框checkBox、日期date、数字number、单选用户user） options String 项目用例自定义字段选项（数字类型时，数组两个值，第一个是最小值，第二个是最大值） description String 项目用例自定义字段描述 creator String 项目用例自定义字段创建人 updater String 项目用例自定义字段更新人 custom_field_id Integer 项目用例自定义字段id（1-25数字） custom_field_name String 项目用例自定义字段名称 custom_field_param String 项目用例自定义字段入参或者返回参数名称 type_name String 项目用例自定义字段类型国际化名称 create_time String 项目用例自定义字段创建时间 create_time_timestamp Long 项目用例自定义字段创建时间时间戳 update_time String 项目用例自定义字段更新时间 update_time_timestamp Long 项目用例自定义字段更新时间时间戳 project_uuid String 项目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 业务失败的提示内容

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 code String 错误码 error CommonResponseErrorAvailableConfig object 统一错误返回 reason String 失败原因 result AvailableConfig object 结果 status String 状态 表4 CommonResponseErrorAvailableConfig 参数 参数类型 描述 code String 错误码 detail AvailableConfig object 错误信息详情 reason String 错误原因 表5 AvailableConfig 参数 参数类型 描述 custom_aw_available Boolean 自定义关键字是否开通 public_aw_available Boolean 系统关键字是否开通 refresh_aw_available Boolean 一键刷新功能是否开通

响应示例 状态码： 200 OK { "status" : "success", "result" : { "public_aw_available" : true, "custom_aw_available" : true, "refresh_aw_available" : true }, "reason" : null, "error" : null, "code" : null }

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 uri String 资源URI type String 资源类型 author String 创建人 name String 名称 rank Integer 级别 preparation String 前置条件 remark String 备注 stage String 测试阶段 activity String 测试类型 keywords String 关键词 market String apitest标记是否代码已提交 designer String 设计者 tags String 标签 execute_parameter String 执行参数 region String 逻辑region owner String 处理人id，IteratorTestCase字段 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 编号 case_type Integer 用例类型 platform_type Integer 执行平台类型 service_type Integer 服务类型 service_type_name String 服务类型名称 test_type Integer 测试类型 test_type_name String 测试类型名称 design_note String 设计描述 test_step String 测试步骤 expect_output String 期望结果 env_type String 测试环境类型 exe_platform String 执行平台 testcase_project String 测试工程 svn_script_path String 脚本路径 map_restrict String 约束条件 network_script_name String 网络脚本名 auto_type Integer 自动化类型，非自动化:0, 是自动化:1 to_be_auto_exec Integer 被自动化执行 last_result String 最后一次结果 last_result_uri String 最后一次结果Uri feature_uri String 目录Uri feature_name String 目录名称 interface_name String 测试接口名 snp_no String 网络问题ID dr_relation_id String 关联需求编号 issue_name String 需求名称 test_base_num String 测试基数 automatically_executed Integer 是否被自动化执行 first_execute_time String 第一次执行时间 detect_type String 检测类型 execute_param String 执行参数 test_feature String 分析领域 is_contract_testcase Integer 是否是契约用例，0:表示非契约用例, 1：表示契约用例 time_cost Double 总共耗时 be_auto_type_time String 记录用例由非自动化变为自动化类型的时间 compare_number String 配对用例编号 scene_flag String 场景标识 base_flag String 场景标识 para_validator String 区别是否从yaml中生成的用例，默认false knet_node_id String knet节点id last_exe_author String 最后一次执行用户 cloud_carrier String 运营商 market_place String 应用市场 test_mind_id String 脑图id test_mind_url String 脑图url commit_url String git提交url test_pattern_number String 测试模式编号 test_factor_number String 测试因子编号 status_code String 状态Code result_code String 结果Code release_id String 迭代ID label_id String 标签ID labels String 用例标签名称列表 module_id String 模块ID module_name String 模块名称 module_path String 模块path module_path_name String 模块路径名称 execute_latest_time String 最后执行时间 execute_duration String 执行时长 execute_times Integer 执行次数 is_keyword Integer 是否关键用例 release_dev String 测试版本号 new_created String 是否用户新增用例 project_uuid String 项目ID creation_version_name String 创建版本名称，原逻辑marshall添加字段 feature_path String 特性路径，原逻辑marshall添加字段 testcase_uri String 实体用例Uri，IteratorTestCase字段 owner_name String 处理人名称 iterator_case_uri String 迭代用例Uri，IteratorTestCase字段 script_link String 脚本链接scriptLink custom_field_1 String 自定义字段1 custom_field_2 String 自定义字段2 custom_field_3 String 自定义字段3 custom_field_4 String 自定义字段4 custom_field_5 String 自定义字段5 custom_field_6 String 自定义字段6 custom_field_7 String 自定义字段7 custom_field_8 String 自定义字段8 custom_field_9 String 自定义字段9 custom_field_10 String 自定义字段10 custom_field_11 String 自定义字段11 custom_field_12 String 自定义字段12 custom_field_13 String 自定义字段13 custom_field_14 String 自定义字段14 custom_field_15 String 自定义字段15 custom_field_16 String 自定义字段16 custom_field_17 String 自定义字段17 custom_field_18 String 自定义字段18 custom_field_19 String 自定义字段19 custom_field_20 String 自定义字段20 custom_field_21 String 自定义字段21 custom_field_22 String 自定义字段22 custom_field_23 String 自定义字段23 custom_field_24 String 自定义字段24 custom_field_25 String 自定义字段25 状态码： 400 表7 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 401 表8 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 404 表9 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码： 500 表10 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容