华为云用户手册

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value BackgroundInfoVo object reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表4 BackgroundInfoVo 参数 参数类型 描述 project_uuid String 项目id cover_file_name String cover文件名称 background_file_name String 背景文件名称 logo_file_name String logo文件名称 状态码：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 表5 响应Body参数 参数 参数类型 描述 code String 参数解释： 接口调用错误码 data Array of SystemConfig objects 系统配置数据 message String 参数解释： 接口调用错误信息 表6 SystemConfig 参数 参数类型 描述 id String 参数解释： 系统配置编号 取值范围： 大小写字母、数字。 key AnyType 参数解释： 系统配置名称 取值范围： 大小写字母、数字、符号。 value String 参数解释： 系统配置值 取值范围： 大小写字母、数字、符号。 remark String 参数解释： 描述 取值范围： 大小写字母、数字、符号。 region_id String 参数解释： 区域id 取值范围： 大小写字母、数字、符号。 project_id String 参数解释： 项目ID 取值范围： 大小写字母、数字。 长度限制固定32位 update_time String 参数解释： 更新时间 update_name String 参数解释： 更新人名称 取值范围： 大小写字母、数字、符号、中文。 update_num String 参数解释： 更新人ID 取值范围： 大小写字母、数字。 状态码：400 表7 响应Body参数 参数 参数类型 描述 code String 参数解释： 接口调用错误码 data String 接口调用返回体 message String 参数解释： 接口调用错误信息 状态码：401 表8 响应Body参数 参数 参数类型 描述 code String 参数解释： 接口调用错误码 data String 接口调用返回体 message String 参数解释： 接口调用错误信息

响应示例 状态码：200 OK { "code" : "success", "data" : [ { "id" : "ae3b4faf12f84ba1aa1c1fa372ec3dfd", "key" : "generateCaseStepByStep", "value" : "0", "remark" : null, "region_id" : "{region_id}", "project_id" : "fb07002bf4ae4317a855b590a86a52e0", "update_time" : "2024/06/07 10:50:21 GMT+08:00", "update_name" : "devcloud_testman_01", "update_num" : "e8ad9e7478c94f4eaf90d5a379af9cb1" } ], "message" : null } 状态码：400 Bad Request { "error_code" : "TESTMIND.00021882", "error_msg" : "分支、计划id长度不合法，请稍后重试" } 状态码：401 Unauthorized { "error_code" : "DEV.00000003", "error_msg" : "认证信息过期" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释： 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 必传。 取值范围： 字符串长度不少于1，不超过10万。 默认取值： 不涉及。 表3 请求Body参数 参数 是否必选 参数类型 描述 params 是 SystemConfig object 系统配置信息 表4 SystemConfig 参数 是否必选 参数类型 描述 id 否 String 参数解释： 系统配置编号 取值范围： 大小写字母、数字。 key 否 AnyType 参数解释： 系统配置名称 取值范围： 大小写字母、数字、符号。 value 否 String 参数解释： 系统配置值 取值范围： 大小写字母、数字、符号。 remark 否 String 参数解释： 描述 取值范围： 大小写字母、数字、符号。 region_id 否 String 参数解释： 区域id 取值范围： 大小写字母、数字、符号。 project_id 否 String 参数解释： 项目ID 取值范围： 大小写字母、数字。 长度限制固定32位 update_time 否 String 参数解释： 更新时间 update_name 否 String 参数解释： 更新人名称 取值范围： 大小写字母、数字、符号、中文。 update_num 否 String 参数解释： 更新人ID 取值范围： 大小写字母、数字。

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 value Array of AttachmentVo objects 实际的数据类型：单个对象，集合 或 NULL 表5 AttachmentVo 参数 参数类型 描述 uri String 附件Uri creator String 创建人 updator String 更新人 region String 逻辑region doc_id String 文档id parent_uri String 父节点Uri parent_type String 父节点类型 file_name String 文件名 store_file_name String 保存文件名 file_path String 文件路径 file_size Integer 文件大小 file_type String 文件类型 system_type String 系统区分：docman或testman create_time String 创建时间 create_time_timestamp Long 创建时间时间戳 update_time String 更新时间 update_time_timestamp Long 更新时间时间戳 project_uuid String 项目id related_type String 附件类型 0 本地上传 other 关联文档 状态码：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 参数解释: 业务失败的提示内容 取值范围: 不涉及

响应示例 状态码：200 OK { "value" : [ { "uri" : "v90b000109n4c8kn", "creator" : "dfc5347b9b16491e942ce55ce7f79dbc", "region" : { "region" : null }, "doc_id" : "", "parent_uri" : "v901000109n3a3mt", "parent_type" : "TestCase", "file_name" : "20220802-091407( WeLink PC).png", "store_file_name" : "20220802-091407(WeLinkPC).png", "file_path" : "attachment_obs/90f8dc52eb7b4c47b853c661152ca62d/TestCase/v901000109n3a3mt/20220802-091407(WeLinkPC).png", "file_size" : 67962, "system_type" : "testman", "create_time" : "2025-03-03 15:54:12", "create_time_timestamp" : 1740988452000, "update_time" : "2025-03-03 15:54:12", "update_time_timestamp" : 1740988452000, "project_uuid" : "90f8dc52eb7b4c47b853c661152ca62d" } ] }

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

响应示例 状态码：200 OK { "code" : "success", "data" : { "total" : 1, "list" : [ { "id" : "1cfb40efafa14e3f812b51028502bad5", "project_id" : "76667cb543a14cacac2ade913ca44a47", "resource_id" : "fb6bd82a6c084fdab0d8e5d8f820eabc", "resource_type" : "mindmap", "operator" : "efdb403066474ab08836b9eeaaa23bca", "operation_type" : "updateMindmapCreatorInfo", "operation_batch_id" : null, "operation_detail" : "{\"new_user_num\":\"昵称xxx1111144445454545\",\"old_user_num\":\"--\",\"update_business_type\":\"mindmap\",\"update_resource_id\":\"fb6bd82a6c084fdab0d8e5d8f820eabc\"}", "create_time" : "2025/01/13 14:52:00 GMT+08:00", "creator_name" : "user", "creator_num" : "efdb403066474ab08836b9eeaaa23bca", "is_delete" : false, "delete_batch_id" : null } ], "offset" : 1, "limit" : 5, "pages" : 1, "size" : 1 }, "message" : null }

请求示例 根据条件信息查询资源操作记录 post https://{endpoint}/v1/b94c9a6947a44597891e0a7362e7383f/operation-record { "params" : { "operation_type" : "updateMindmapCreatorInfo", "resource_type" : "feature_root_id", "resource_id" : "mindmap", "offset" : 1, "limit" : 5 } }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释： 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 必传。 取值范围： 字符串长度不少于1，不超过10万。 默认取值： 不涉及。 表3 请求Body参数 参数 是否必选 参数类型 描述 params 是 ResourceOpetaionRecordPageParam object 请求体 表4 ResourceOpetaionRecordPageParam 参数 是否必选 参数类型 描述 offset 否 Integer 参数解释： 起始偏移量，表示从此偏移量开始查询，offset大于等于0，小于等于100000 limit 否 Integer 参数解释： 每页显示的条目数量，最大支持200条 resource_id 否 String 资源ID resource_type 否 String 资源类型 operation_type 否 String 操作类型

响应示例 状态码：200 SUC CES S { "status" : "success", "result" : { "page_no" : 1, "page_size" : 1, "total_page" : 1, "total_size" : 1, "page_list" : [ { "id" : "a97fc86638e24308a61b68f5abb8ef8f", "type" : "String", "name" : "New_Variable_1", "property" : "test", "description" : "", "locked" : 1, "groupId" : "c8eae5907ad24f43b280babb4a14a8f2", "category" : "Static", "isSensitiveInfo" : true, "isSensitiveModified" : false, "sourceId" : null, "variableType" : 0, "functionParams" : "", "dynamicParamFlag" : false, "sensitiveInfoSetterUser" : "w30036875", "sensitiveInfoSetterTime" : "2025-02-07T02:33:39+0800", "currentPermission" : "0", "region" : "cn-north-7", "create_time_string" : "2025-02-07 14:33:39 GMT+08:00", "update_time_string" : "2025-02-07 14:33:39 GMT+08:00", "create_time_stamp" : 1738910019000, "update_time_stamp" : 1738910019000, "create_user" : "w30036875", "create_time" : "2025-02-07T02:33:39+0800", "update_user" : "w30036875", "update_time" : "2025-02-07T02:33:39+0800", "parent_id" : "2d8247c5e9424bccb0cfa8a47b5d311c", "node_type" : 0, "node_id" : "09e85552c6ebbb99527f548abdeafa0", "parent_node_id" : null, "by_order" : 1 } ] }, "reason" : null, "error" : null, "code" : null, "costTimeResult" : null }

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 code String 参数解释 接口调用失败错误码 error CommonResponseErrorOfAPITest object 统一错误返回 reason String 参数解释 接口调用失败原因 result PageResults object 结果 status String 参数解释 接口调用状态 costTimeResult String 参数解释 提交耗时 表5 CommonResponseErrorOfAPITest 参数 参数类型 描述 code String 参数解释 接口调用失败错误码 reason String 参数解释 接口调用失败原因 表6 PageResults 参数 参数类型 描述 page_list Array of VariableRes objects 参数解释 全局变量列表 page_no Integer 参数解释 当前分页 page_size Integer 参数解释 分页大小 total_page Integer 参数解释 分页总数 total_size Long 参数解释 全局变量总数 表7 VariableRes 参数 参数类型 描述 by_order Integer 参数解释 变量顺序 category String 参数解释 变量静态/动态类型 取值范围 Dynamic或者Static create_time String 参数解释 变量创建时间 create_time_stamp Long 参数解释 变量创建时间（时间戳格式） create_time_string String 参数解释 变量创建时间（字符串格式） create_user String 参数解释 变量创建者 currentPermission String 参数解释 当前用户权限 description String 参数解释 变量描述信息 dynamicParamFlag Boolean 参数解释 是否为动态变量 取值范围 true或false，true表示是动态变量，false表示非动态变量 functionParams String 参数解释 变量参数 groupId String 参数解释 分组id id String 参数解释 变量编号 isSensitiveInfo Boolean 参数解释 是否为敏感变量 取值范围 true或false，true表示是敏感变量，false表示非敏感变量 isSensitiveModified Boolean 参数解释 敏感变量是否被修改 取值范围 true或false，true表示敏感变量被修改，false表示敏感变量未被修改 locked Integer 参数解释 是否被锁定 name String 参数解释 变量名 取值范围 0-300个字符组成的字符串 node_id String 参数解释 节点编号 node_type Integer 参数解释 节点类型 parent_id String 参数解释 所属父节点编号 parent_node_id String 参数解释 父节点编号 property String 参数解释 变量值 取值范围 1-65535个字符组成的字符串 region String 参数解释 所在region sensitiveInfoSetterTime String 参数解释 敏感变量设置时间 sensitiveInfoSetterUser String 参数解释 敏感变量设置者 sourceId String 参数解释 复制的全局变量的源id type String 参数解释 变量类型 取值范围 Long|Double|Boolean|BigDecimal|String|Integer|csv update_time String 参数解释 变量更新时间 update_time_stamp Long 参数解释 变量更新时间（时间戳格式） update_time_string String 参数解释 变量更新时间（字符串格式） update_user String 参数解释 变量更新者 variableType Integer 参数解释 变量类型 取值范围 0-18 状态码：201 Created 状态码：401 Unauthorized 状态码：403 Forbidden 状态码：404 Not Found

URI GET /v4/{project_id}/variables 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID。 约束限制 不涉及 取值范围 32个字符组成的字符串 默认取值 不涉及 表2 Query参数 参数 是否必选 参数类型 描述 group_id 否 String 参数解释 分组id 约束限制 不涉及 取值范围 32个字符组成的字符串 默认取值 不涉及 page_no 否 String 参数解释 当前页数 约束限制 不涉及 取值范围 0-999999999 默认取值 不涉及 page_size 否 String 参数解释 每页的记录数 约束限制 不涉及 取值范围 0-1000 默认取值 不涉及

响应参数 状态码：200 表5 响应Body参数 参数 参数类型 描述 status String 参数解释 success|error; 取值范围 success|error result ResultValueStringForOk object 请求结果 表6 ResultValueStringForOk 参数 参数类型 描述 value String 参数解释 ok 取值范围 不涉及 状态码：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 参数解释: 业务失败的提示内容 取值范围: 不涉及

请求示例 post https://{endpoint}/testrelation/v4/workitems/16228817/relations { "relations" : [ { "dr_number" : "3325606", "test_case_uri" : "223685", "relate_type" : "bug/requirement", "resource_type" : "testcase/testitem", "source_system" : "vision", "association_number" : "223685", "region" : "szv" } ], "tracker_id" : "1", "version_uri" : "932opbu6aaf", "task_uri" : "59281152185", "add_to_iterator" : true, "project_uuid" : "223685eqweqwe1112w" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） 约束限制 不涉及 取值范围 字符串长度不少于1，不超过100000 默认取值 不涉及 表3 请求Body参数 参数 是否必选 参数类型 描述 relations 否 Array of RelationInfo objects 关联关系 tracker_id 否 String 参数解释 工作项类型id 约束限制 1到20位数字 取值范围 不涉及 默认取值 不涉及 version_uri 否 String 参数解释 版本uri 约束限制 11到34位英文或数字 取值范围 不涉及 默认取值 不涉及 task_uri 否 String 参数解释 测试套id 约束限制 11到34位英文或数字 取值范围 不涉及 默认取值 不涉及 add_to_iterator 否 Boolean 参数解释 是否将需求添加到迭代 约束限制 11到34位英文或数字 取值范围 不涉及 默认取值 不涉及 project_uuid 否 String 参数解释 项目id，对应"需求管理 CodeArts Req"项目唯一标识，测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值 约束限制 不涉及 取值范围 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 默认取值 不涉及 表4 RelationInfo 参数 是否必选 参数类型 描述 dr_number 是 String 参数解释 需求id 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 test_case_uri 否 String 参数解释 用例uri 约束限制 不涉及 取值范围 11到34位英文或数字 默认取值 不涉及 relate_type 是 String 参数解释 资源类型 约束限制 不涉及 取值范围 bug/requirement 默认取值 不涉及 resource_type 否 String 参数解释 资源类型 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 source_system 否 String 参数解释 来源系统 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 association_number 否 String 参数解释 关联资源编号 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 region 否 String 参数解释 逻辑region，外部使用公有云实际区域，内部使用默认值 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 status String 参数解释 接口返回状态，ok-成功，failed-失败 约束限制 不涉及 取值范围 ok,failed 默认取值 ok result Boolean 参数解释 模板名是否重复 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 状态码：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 GET /v1/projects/{service_id}/alert-templates/name 表1 路径参数 参数 是否必选 参数类型 描述 service_id 是 String 参数解释 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID。 约束限制 不涉及 取值范围 32个字符组成的字符串 默认取值 不涉及 表2 Query参数 参数 是否必选 参数类型 描述 id 否 String UUID name 是 String 查询的模板名称

URI GET /v4/{project_id}/testcase/{tmss_case_uri} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID。 约束限制 不涉及 取值范围 32个字符组成的字符串 默认取值 不涉及 tmss_case_uri 是 String TMSS用例uri 表2 Query参数 参数 是否必选 参数类型 描述 task_id 否 String 执行任务id

响应示例 状态码：200 OK { "status" : "success", "result" : { "id" : "10896ab1bab34bd8a81b9751fb5c0f4f", "name" : "123", "changeSign" : 0, "copyFlag" : false, "region" : "cn-north-7", "create_time_string" : "2024-06-21 14:10:05 GMT+08:00", "update_time_string" : "2024-06-21 14:10:10", "create_time_stamp" : 1718950205000, "update_time_stamp" : 1718950210000, "create_user" : "devcloud_devcloud_s00314720_01", "create_time" : 1718950205000, "update_user" : "devcloud_devcloud_s00314720_01", "update_time" : 1718950210000, "tmss_property" : { "name" : "123", "number" : "104", "level" : 2, "node_name" : "其他", "test_type" : 1, "testStep" : "", "expectOutput" : "", "exe_platform" : "apitest", "auto_type" : "1", "test_feature" : "09645c1f3f954a8d9ab29174857cffc5_32559725_defaultFeature", "last_modified" : "2024-06-21 14:10:10", "last_modifier" : "efdb403066474ab08836b9eeaaa23bca", "author" : "1_devcloud_devcloud_s00314720", "creation_date" : "2024-06-21 14:10:05", "activity_id" : "1", "last_result" : "0", "isKeyWord" : 0 }, "project_id" : "23c1c5ba3b3c4e92b8adaab3529913c4", "activity_id" : "1", "package_name" : "scripts.user", "script_name" : "Case_10896ab1bab34bd8a81b9751fb5c0f4f_2", "script_path" : "src/scripts/user/Case_10896ab1bab34bd8a81b9751fb5c0f4f_2.java", "tmss_case_uri" : "v91j0000vl6b2b2e", "aw_instance" : { "setup_aw_list" : [ ], "test_aw_list" : [ { "id" : "6e11373667fe46f9881fd216cd1e4404", "projectId" : "23c1c5ba3b3c4e92b8adaab3529913c4", "changeSign" : 0, "region" : "cn-north-7", "relation" : "", "create_time_string" : "2024-06-21 14:10:10 GMT+08:00", "update_time_string" : "2024-06-21 14:10:10 GMT+08:00", "create_time_stamp" : 1718950210000, "update_time_stamp" : 1718950210000, "create_user" : "devcloud_devcloud_s00314720_01", "create_time" : 1718950210000, "update_user" : "devcloud_devcloud_s00314720_01", "update_time" : 1718950210000, "condition_type" : 20, "condition_statement" : "1000", "aw_type" : 1, "aw_id" : "", "param_type_and_value" : [ ], "check_point_list" : [ ], "variable_list" : [ ], "retry_times" : "", "retry_interval" : "", "by_order" : 0, "is_disabled" : 0, "relation_type" : 0, "custom_header" : [ ], "is_basic" : 1, "special_type" : 0, "alias_runaw" : "" } ], "teardown_aw_list" : [ ] }, "case_variable_list" : [ ], "quality_check_time" : 970970555000, "import_info_list" : [ ], "IsKeyWord" : 0, "all_variable_names" : [ "$${hostURL}(全局参数)" ], "import_edit" : 5, "case_type" : 0 } }

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 error CommonResponseErrorOfobject object 统一错误返回 reason String 错误原因 result Object 结果 status String 状态值，如success、error 表4 CommonResponseErrorOfobject 参数 参数类型 描述 code String 错误码 reason String 错误原因 状态码：201 Created 状态码：401 Unauthorized 状态码：403 Forbidden 状态码：404 Not Found

响应示例 状态码：200 SUCCESS { "status" : "success", "result" : { "paramNames" : [ { "dynamicParamFlag" : false, "isSensitive" : false, "name" : "hostURL", "category" : "Static" } ] }, "reason" : null, "error" : null }

响应示例 状态码：200 OK { "status" : "success", "result" : { "value" : { "uri" : "v92t00010e7buhie", "type" : "TestCase", "author" : "f3b807a0d249424fa36a0d804110c4ed", "name" : "新建的测试用例", "rank" : 2, "stage" : "1", "designer" : "f3b807a0d249424fa36a0d804110c4ed", "region" : "cn-north-7", "last_modifier" : "f3b807a0d249424fa36a0d804110c4ed", "last_modified" : "2025-04-28 16:17:09", "last_change_time" : "2025-04-28 16:17:09", "version_uri" : "v92s00010db208e5", "parent_uri" : "v92s00010db208e5", "parent_path" : "/dc3f9aa646ad4707831080d3fcce474d/v92s00010db208e5/", "creation_version_uri" : "v92s00010db208e5", "creation_date" : "2025-04-28 16:17:09", "number" : "102", "case_type" : 0, "platform_type" : 0, "service_type" : 0, "test_type" : 1, "test_step" : "[\"\"]", "expect_output" : "[\"\"]", "auto_type" : 0, "to_be_auto_exec" : 0, "automatically_executed" : 0, "is_contract_testcase" : 0, "time_cost" : 0.0, "status_code" : "0", "execute_times" : 0, "project_uuid" : "dc3f9aa646ad4707831080d3fcce474d", "creation_version_name" : "基线" } } }

请求示例 post https://{endpoint}/GT3KServer/v4/versions/v92s00010db209le/testcases { "project_uuid" : "dc3f9aa646ad4707831080d3fcce474d", "version_uri" : "v92s00010db209le", "service_type" : 0, "relate_type" : "requirement", "name" : "新建的测试用例", "remark" : "", "preparation" : "", "svn_script_path" : "", "steps" : [ { "test_step" : "", "expect_result" : "" } ], "number" : "", "rank" : 2, "module_id" : "", "release_dev" : "", "release_id" : "", "owner" : "", "test_type" : 1, "label_names" : [ ], "dr_relation_id" : "", "attachments" : [ ] }

响应参数 状态码：200 表6 响应Body参数 参数 参数类型 描述 status String 参数解释: 本次请求的处理状态 取值范围: success|error result ResultValueTestCaseVo object 参数解释: 请求返回的结果 取值范围: 不涉及 error ApiError object 参数解释: 错误信息 取值范围: 不涉及 request_id String 参数解释: 由接口调用方传入，建议使用UUID保证请求的唯一性。 取值范围: 不涉及 server_address String 参数解释: 本次请求的受理的服务地址 取值范围: 不涉及 表7 ResultValueTestCaseVo 参数 参数类型 描述 total Integer 参数解释: 符合条件的所有记录数 取值范围: 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value TestCaseVo object 实际的数据类型：单个对象，集合 或 NULL reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 page_size Integer 参数解释: 每页展示条数 取值范围: 1-100 page_no Integer 参数解释: 页码 取值范围: 1-20000 has_more Boolean 参数解释: 是否有更多 取值范围: true:有更多 false:无更多 表8 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 test_step_model String 测试步骤模式 text: 文本模式; table: 表格模式 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 表9 ApiError 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：400 表10 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：401 表11 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：404 表12 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：500 表13 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） 约束限制 不涉及 取值范围 字符串长度不少于1，不超过100000 默认取值 不涉及 表3 请求Body参数 参数 是否必选 参数类型 描述 steps 否 Array of TestCaseStepInfo objects 参数解释: 测试步骤 约束限制: 不涉及 取值范围: 0-100 默认取值: 不涉及 attachments 否 Array of TestCaseAttachmentInfo objects 参数解释: 附件 约束限制: 不涉及 取值范围: 0-100 默认取值: 不涉及 author 否 String 参数解释 创建人 约束限制 1-32个英文或者数字 取值范围 不涉及 默认取值 不涉及 name 是 String 参数解释 名称 约束限制 长度限制128字符 取值范围 不涉及 默认取值 不涉及 rank 否 Integer 参数解释 用例等级 约束限制 不涉及 取值范围 取值范围：0,1,2,3,4 默认取值 不涉及 owner 否 String 参数解释 处理人 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 preparation 否 String 参数解释 前置条件 约束限制 长度限制3000字符 取值范围 不涉及 默认取值 不涉及 remark 否 String 参数解释 备注 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 stage 否 String 参数解释 测试阶段 约束限制 长度限制50字符 取值范围 不涉及 默认取值 不涉及 activity 否 String 参数解释 测试类型 约束限制 长度限制64字符 取值范围 不涉及 默认取值 不涉及 keywords 否 String 参数解释 关键词 约束限制 长度限制512字符 取值范围 不涉及 默认取值 不涉及 market 否 String 参数解释 apitest标记是否代码已提交 约束限制 长度限制1024字符 取值范围 不涉及 默认取值 不涉及 designer 否 String 参数解释 设计者 约束限制 长度限制64字符 取值范围 不涉及 默认取值 不涉及 tags 否 String 参数解释 标签 约束限制 长度限制512字符 取值范围 不涉及 默认取值 不涉及 region 否 String 参数解释 逻辑region，外部使用公有云实际区域，内部使用默认值 约束限制 长度限制32字符 取值范围 不涉及 默认取值 不涉及 relate_type 否 String 参数解释 关联资源类型 约束限制 不涉及 取值范围 取值范围：requirement|bug 默认取值 不涉及 service_type 否 Integer 参数解释 服务类型 约束限制 1到7位数字 取值范围 不涉及 默认取值 不涉及 only_change_script 否 String 参数解释 更新接口用例的java脚本路径标识 约束限制 长度限制32字符 取值范围 不涉及 默认取值 不涉及 add_to_iterator 否 String 参数解释 需求添加到迭代标识 约束限制 长度限制5字符 取值范围 不涉及 默认取值 不涉及 need_update_relation 否 String 参数解释 是否修改关联关系 约束限制 长度限制5字符 取值范围 不涉及 默认取值 不涉及 creation_version_uri 否 String 参数解释 创建版本Uri 约束限制 11到34位英文或数字 取值范围 不涉及 默认取值 不涉及 number 否 String 参数解释 用例编号 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 case_type 否 Integer 参数解释 用例类型 约束限制 不涉及 取值范围 取值范围：-128-127 默认取值 不涉及 platform_type 否 Integer 参数解释 执行平台类型 约束限制 不涉及 取值范围 取值范围：-128-127 默认取值 不涉及 test_type 否 Integer 参数解释 测试类型 约束限制 不涉及 取值范围 取值范围：-128-127 默认取值 不涉及 design_note 否 String 参数解释 设计描述 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 test_step 否 String 参数解释 测试步骤 约束限制 长度限制250000字符 取值范围 不涉及 默认取值 不涉及 expect_output 否 String 参数解释 期望结果 约束限制 长度限制250000字符 取值范围 不涉及 默认取值 不涉及 env_type 否 String 参数解释 测试环境类型 约束限制 长度限制512字符 取值范围 不涉及 默认取值 不涉及 exe_platform 否 String 参数解释 执行平台 约束限制 长度限制200字符 取值范围 不涉及 默认取值 不涉及 testcase_project 否 String 参数解释 测试工程 约束限制 长度限制1024字符 取值范围 不涉及 默认取值 不涉及 svn_script_path 否 String 参数解释 脚本路径 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 map_restrict 否 String 参数解释 约束条件 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 network_script_name 否 String 参数解释 网络脚本名 约束限制 长度限制500字符 取值范围 不涉及 默认取值 不涉及 auto_type 否 Integer 参数解释 自动化类型，非自动化:0, 是自动化:1 约束限制 长度限制500字符 取值范围 取值范围：0,1 默认取值 不涉及 to_be_auto_exec 否 Integer 参数解释 被自动化执行 约束限制 不涉及 取值范围 -128-127 默认取值 不涉及 last_result 否 String 参数解释 最后一次结果 约束限制 长度限制16字符 取值范围 不涉及 默认取值 不涉及 last_result_uri 否 String 参数解释 最后一次结果Uri 约束限制 不涉及 取值范围 11-34位数字或英文 默认取值 不涉及 feature_uri 否 String 参数解释 目录Uri 约束限制 不涉及 取值范围 11-34位数字或英文 默认取值 不涉及 interface_name 否 String 参数解释 测试接口名 约束限制 长度限制200字符 取值范围 不涉及 默认取值 不涉及 snp_no 否 String 参数解释 网络问题ID 约束限制 长度限制500字符 取值范围 不涉及 默认取值 不涉及 dr_relation_id 否 String 参数解释 关联需求编号 约束限制 不涉及 取值范围 1-32位数字 默认取值 不涉及 test_base_num 否 String 参数解释 测试基数 约束限制 长度限制200字符 取值范围 不涉及 默认取值 不涉及 automatically_executed 否 Integer 参数解释 是否被自动化执行 约束限制 不涉及 取值范围 -128-127 默认取值 不涉及 first_execute_time 否 String 参数解释 第一次执行时间 约束限制 d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2} 取值范围 不涉及 默认取值 不涉及 detect_type 否 String 参数解释 检测类型 约束限制 长度限制100字符 取值范围 不涉及 默认取值 不涉及 execute_param 否 String 参数解释 执行参数 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 test_feature 否 String 参数解释 分析领域 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 is_contract_testcase 否 Integer 参数解释 是否是契约用例，0:表示非契约用例, 1：表示契约用例 约束限制 不涉及 取值范围 0,1 默认取值 不涉及 time_cost 否 Double 参数解释 总共耗时 约束限制 不涉及 取值范围 2147483648.44-2147483647.44 默认取值 不涉及 custom_field_1 否 String 参数解释 自定义字段1 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_2 否 String 参数解释 自定义字段2 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_3 否 String 参数解释 自定义字段3 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_4 否 String 参数解释 自定义字段4 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_5 否 String 参数解释 自定义字段5 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_6 否 String 参数解释 自定义字段6 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_7 否 String 参数解释 自定义字段7 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_8 否 String 参数解释 自定义字段8 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_9 否 String 参数解释 自定义字段9 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_10 否 String 参数解释 自定义字段10 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_11 否 String 参数解释 自定义字段11 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_12 否 String 参数解释 自定义字段12 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_13 否 String 参数解释 自定义字段13 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_14 否 String 参数解释 自定义字段14 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_15 否 String 参数解释 自定义字段15 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_16 否 String 参数解释 自定义字段16 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_17 否 String 参数解释 自定义字段17 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_18 否 String 参数解释 自定义字段18 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_19 否 String 参数解释 自定义字段19 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_20 否 String 参数解释 自定义字段20 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_21 否 String 参数解释 自定义字段21 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_22 否 String 参数解释 自定义字段22 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_23 否 String 参数解释 自定义字段23 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_24 否 String 参数解释 自定义字段24 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 custom_field_25 否 String 参数解释 自定义字段25 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 be_auto_type_time 否 String 参数解释 记录用例由非自动化变为自动化类型的时间 约束限制 d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2} 取值范围 不涉及 默认取值 不涉及 compare_number 否 String 参数解释 配对用例编号 约束限制 长度限制100字符 取值范围 不涉及 默认取值 不涉及 scene_flag 否 String 参数解释 场景标识 约束限制 长度限制50字符 取值范围 不涉及 默认取值 不涉及 base_flag 否 String 参数解释 场景标识 约束限制 长度限制50字符 取值范围 不涉及 默认取值 不涉及 para_validator 否 String 参数解释 区别是否从yaml中生成的用例，默认false 约束限制 长度限制50字符 取值范围 不涉及 默认取值 false knet_node_id 否 String 参数解释 knet节点id 约束限制 长度限制50字符 取值范围 不涉及 默认取值 不涉及 last_exe_author 否 String 参数解释 最后一次执行用户 约束限制 长度限制50字符 取值范围 不涉及 默认取值 不涉及 cloud_carrier 否 String 参数解释 运营商 约束限制 长度限制100字符 取值范围 不涉及 默认取值 不涉及 market_place 否 String 参数解释 应用市场 约束限制 长度限制1024字符 取值范围 不涉及 默认取值 不涉及 test_mind_id 否 String 参数解释 脑图id 约束限制 长度限制256字符 取值范围 不涉及 默认取值 不涉及 test_mind_url 否 String 参数解释 脑图url 约束限制 长度限制1024字符 取值范围 不涉及 默认取值 不涉及 commit_url 否 String 参数解释 git提交url 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 test_pattern_number 否 String 参数解释 测试模式编号 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 test_factor_number 否 String 参数解释 测试因子编号 约束限制 长度限制65535字符 取值范围 不涉及 默认取值 不涉及 status_code 否 String 参数解释 状态Code 约束限制 [-]?[0-9]{1,5} 取值范围 不涉及 默认取值 不涉及 result_code 否 String 参数解释 测试因子编号 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 release_id 否 String 参数解释 迭代ID 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 label_id 否 String 参数解释 标签ID 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 label_names 否 Array of strings 参数解释 用例操作时，标签名列表 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 module_id 否 String 参数解释 模块ID 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 execute_latest_time 否 String 参数解释 最后执行时间 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 execute_duration 否 String 参数解释 执行时长 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 is_keyword 否 Integer 参数解释 是否关键用例 约束限制 不涉及 取值范围 -128-127 默认取值 不涉及 release_dev 否 String 参数解释 测试版本号 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 new_created 否 Integer 参数解释 是否用户新增用例 约束限制 不涉及 取值范围 -128-127 默认取值 不涉及 execute_parameter 否 String 参数解释 执行参数 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 project_uuid 否 String 参数解释 项目ID，外部使用项目ID，内部使用默认值 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 version_uri 否 String 参数解释 分支或者迭代uri 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 表4 TestCaseStepInfo 参数 是否必选 参数类型 描述 test_step 否 String 参数解释 测试步骤 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 expect_result 否 String 参数解释 预期结果 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 step_actual 否 String 参数解释 步骤的实际结果 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 step_result 否 String 参数解释 步骤结果 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 表5 TestCaseAttachmentInfo 参数 是否必选 参数类型 描述 override 否 Boolean 参数解释 附件是否要被覆盖 约束限制 不涉及 取值范围 true|false 默认取值 不涉及 doc_id 否 String 参数解释 文档id 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 file_name 否 String 参数解释 文件名 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 file_path 否 String 参数解释 文件路径 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 file_type 否 String 参数解释 文件类型 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 file_size 否 String 参数解释 文件大小 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 override_id 否 String 参数解释 重复用例ID 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 related_type 否 String 参数解释 相关类型 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 store_file_name 否 String 参数解释 保存文件名 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 system_type 否 String 参数解释 系统区分 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 storage_system 否 String 参数解释 区分文件存储系统 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及

响应示例 状态码：200 OK { "code" : "success", "data" : null, "message" : null } 状态码：400 Bad Request { "error_code" : "TESTMIND.00021882", "error_msg" : "分支、计划id长度不合法，请稍后重试" } 状态码：401 Unauthorized { "error_code" : "DEV.00000003", "error_msg" : "认证信息过期" }

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

URI GET /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 Query参数 参数 是否必选 参数类型 描述 page_no 是 Integer 页数 page_size 是 Integer 页数大小 version_uri 否 String 分支或者测试计划uri

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value Array of TestCaseCommentVo objects 实际的数据类型：单个对象，集合 或 NULL reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表5 TestCaseCommentVo 参数 参数类型 描述 uri String 用例评论id creator String 创建者id comment String 评论内容 notifier Array of strings 评论通知人 test_case_uri String 用例di 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 表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 参数解释: 业务失败的提示内容 取值范围: 不涉及