更新时间:2026-10-22 GMT+08:00
分享

获取分支详情 - ShowBranchFour

功能介绍

此接口用于在版本管理中获取分支详情,对应页面 测试 -> 测试用例 -> 上方版本右侧小齿轮点击查看分支详情

调用方法

请参见如何调用API。

URI

GET /v4/branches/{branch_uri}

表1 路径参数

参数

是否必选

参数类型

描述

branch_uri

是

String

分支URI

表2 Query参数

参数

是否必选

参数类型

描述

project_uuid

是

String

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

请求参数

无

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

value

TestVersionVo object

参数解释

版本资源信息

取值范围

不涉及

表4 TestVersionVo

参数

参数类型

描述

uri

String

参数解释:

资源URI

取值范围:

11-34位长度的字母、数字组成的字符串

type

String

参数解释:

资源类型

取值范围:

  • TestCase,用例。

  • Task,任务。

  • TestVersion,分支。

  • IteratorTestCase,迭代用例。

author

String

参数解释:

创建人

取值范围:

长度小于128个字符的字符串

name

String

参数解释:

名称

取值范围:

长度小于128个字符的字符串

rank

Integer

参数解释:

分支的优先级别

取值范围:

  • 1:低级别

  • 2:中低级别

  • 3:中高级别

  • 4:高级别

version

String

参数解释:

待测版本

取值范围:

不涉及

owner

String

参数解释:

处理者ID

取值范围:

长度小于128个字符的字符串

creator

String

参数解释:

创建人ID

取值范围:

长度小于128个字符的字符串

iterations

String

参数解释:

关联迭代

取值范围:

长度小于128个字符的字符串

description

String

参数解释:

描述

取值范围:

长度小于1024个字符的字符串

region

String

参数解释:

区域

取值范围:

不涉及

last_modifier

String

参数解释:

最后修改人

取值范围:

长度小于128个字符的字符串

last_modified

String

参数解释:

最后修改时间

取值范围:

不涉及,格式:yyyy-MM-dd HH:mm:ss

last_modified_timestamp

Long

参数解释:

修改时间时间戳

取值范围:

不涉及,单位:毫秒级

last_change_time

String

参数解释:

最后变更时间

取值范围:

不涉及,格式:yyyy-MM-dd HH:mm:ss

version_uri

String

参数解释:

版本URI

取值范围:

11-34位字母、数字组成的字符串

origin_uri

String

参数解释:

源资源URI

取值范围:

11-34位字母、数字组成的字符串

parent_uri

String

参数解释:

父资源URI

取值范围:

11-34位字母、数字组成的字符串

parent_path

String

参数解释:

父资源路径

取值范围:

长度小于128个字符的字符串

creation_version_uri

String

参数解释:

创建版本URI

取值范围:

11-34位字母、数字组成的字符串

creation_date

String

参数解释:

创建时间

取值范围:

时间格式为"yyyy-MM-dd HH:mm:ss"

creation_date_timestamp

Long

参数解释:

创建时间时间戳

取值范围:

不涉及,单位:毫秒级

author_name

String

参数解释:

创建人名称

取值范围:

长度小于128个字符的字符串

comment

String

参数解释:

备注

取值范围:

长度小于1024个字符的字符串

number

String

参数解释:

编号

取值范围:

长度小于128个字符的字符串

is_master

Integer

参数解释:

是否为Master分支

取值范围:

  • 0:非Master分支

  • 1:Master分支

is_iterator

Integer

参数解释:

是否为迭代

取值范围:

  • 0:非迭代

  • 1:迭代

plan_start_date

String

参数解释:

开始时间

取值范围:

时间格式为"yyyy-MM-dd HH:mm:ss"

plan_end_date

String

参数解释:

结束时间

取值范围:

时间格式为"yyyy-MM-dd HH:mm:ss"

service_id

String

参数解释:

微服务ID

取值范围:

长度小于128个字符的字符串

service_name

String

参数解释:

微服务名

取值范围:

长度小于128个字符的字符串

pbi_id

String

参数解释:

PBI ID

取值范围:

长度小于128个字符的字符串

pbi_name

String

参数解释:

PBI信息

取值范围:

长度小于128个字符的字符串

plan_id

String

参数解释:

计划ID

取值范围:

11-34位字母和数字组成的字符串

metric_pbi_ids

String

参数解释:

度量PBI ID

取值范围:

长度小于128个字符的字符串

metric_pbi_id_names

String

参数解释:

度量PBI名称

取值范围:

长度小于128个字符的字符串

last_syn_date

String

参数解释:

最后同步时间

取值范围:

时间格式为"yyyy-MM-dd HH:mm:ss"

is_closed

String

参数解释:

版本是否关闭

取值范围:

不涉及

asyn_git

String

参数解释:

是否同步git库

取值范围:

不涉及

schema_no

Integer

参数解释:

schema编号

取值范围:

1-10

finish_date

String

参数解释:

迭代实际完成时间

取值范围:

时间格式为"yyyy-MM-dd HH:mm:ss"

owner_name

String

参数解释:

处理者名称

取值范围:

长度小于128个字符的字符串

creator_name

String

参数解释:

创建人名称

取值范围:

长度小于128个字符的字符串

current_stage

String

参数解释:

当前所处阶段

取值范围:

  • create:创建阶段

  • strategy:策略阶段

  • design:设计阶段

  • execute:执行阶段

  • report:报告阶段

service_types

Array of integers

参数解释:

服务类型集合,数组内每个integer值代表的服务类型含义:-1表示全量用例,0表示手工测试,1表示接口自动化,7表示功能自动化,8表示WebUI自动化,100表示自定义自动化(工厂),11表示性能自动化

取值范围:

不涉及

risk_rating

Integer

参数解释:

风险等级

取值范围:

  • 0:无风险

  • 1:低风险

  • 2:较低风险

  • 3:中等风险

  • 4:较高风险

  • 5:极高风险

risk_des

String

参数解释:

风险描述

取值范围:

最大长度500位字符

project_uuid

String

参数解释:

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

取值范围:

32位字母和数字组成的字符串

domain_id

String

参数解释:

租户ID

取值范围:

11-34位字母和数字组成的字符串

pi_id

String

参数解释:

pi的id

取值范围:

不涉及

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:401

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:404

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:500

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

get https://{endpoint}/v4/branches/v90100010p0crcjn?project_uuid=73ad9ecbf32f44928b51a5d2c96720b8

响应示例

状态码:200

{
  "value" : {
    "uri" : "v90100010p0crcjn",
    "type" : "TestVersion",
    "author" : "c6a01bc6f2984a2098b423ce0ab1fdeb",
    "name" : "基线",
    "region" : "roma-guian-2",
    "last_modifier" : "c6a01bc6f2984a2098b423ce0ab1fdeb",
    "last_modified" : "2025-09-09 16:10:53",
    "last_modified_timestamp" : 1757405453000,
    "last_change_time" : "2025-09-09 16:10:53",
    "version_uri" : "3cb3c18b74f1429783175e6dab05b351",
    "parent_uri" : "3cb3c18b74f1429783175e6dab05b351",
    "parent_path" : "/3cb3c18b74f1429783175e6dab05b351/",
    "creation_version_uri" : "3cb3c18b74f1429783175e6dab05b351",
    "creation_date" : "2025-09-09 16:10:53",
    "creation_date_timestamp" : 1757405453000,
    "is_master" : 1,
    "is_iterator" : 0,
    "service_id" : "3cb3c18b74f1429783175e6dab05b351",
    "service_name" : "IPD-系统设备类_0909",
    "schema_no" : 4,
    "risk_rating" : 0,
    "project_uuid" : "3cb3c18b74f1429783175e6dab05b351"
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

相关文档