获取分支列表 - ListTesthubBranches

功能介绍

此接口用户获取项目下的所有分支列表

测试 -> 测试用例 -> 上方分支右侧小齿轮

调用方法

请参见如何调用API。

URI

GET /v4/testhub/projects/{project_id}/branches

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID

表2 Query参数
参数	是否必选	参数类型	描述
sort_field	否	String	排序字段
sort_type	否	String	参数解释: 排序方式约束限制: 不涉及取值范围: ASC，升序。 DESC，降序。默认取值: 不涉及
offset	是	Integer	起始偏移
limit	是	Integer	页大小

请求参数

无

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
value	Array of ExternalBrancVersionVo objects	详细结果

表4 ExternalBrancVersionVo
参数	参数类型	描述
type	String	参数解释: 资源类型取值范围: TestCase，用例。 Task，任务。 TestVersion，分支。 IteratorTestCase，迭代用例。
author	String	创建人
project_id	String	项目id
name	String	名称
rank	Integer	级别
region	String	区域
last_modifier	String	最后修改人
last_modified	String	最后修改时间
last_modified_timestamp	Long	修改时间时间戳
last_change_time	String	最后变更时间
id	String	资源URI
version_id	String	版本id
parent_id	String	父资源URI
parent_path	String	父资源路径
creation_version_id	String	创建版本id
creation_date	String	创建时间
creation_date_timestamp	Long	创建时间时间戳
author_name	String	创建人名称
comment	String	备注
number	String	编号
is_base_branch	Integer	是否为基线分支

状态码：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/testhub/projects/ab26ad085a594c9baac38216dff3409c/branches

响应示例

状态码：200

{
  "total" : 2,
  "project_id" : "1b7179edc79a431f9711434124ac9f28",
  "values" : [ {
    "author_name" : "wangluodan1",
    "author" : "a17801c5d15f46e28112eec8a880683d",
    "last_modified_timestamp" : 1760686520000,
    "name" : "Branch01",
    "creation_date_timestamp" : 1760686520000,
    "is_base_branch" : 0,
    "id" : "v90100010s25tiq4",
    "creation_date" : "2025-10-17 15:35:20",
    "type" : "TestVersion",
    "region" : "roma-guian-2",
    "last_modified" : "2025-10-17 15:35:20",
    "last_modifier" : "a17801c5d15f46e28112eec8a880683d"
  }, {
    "author_name" : "wangluodan1",
    "author" : "a17801c5d15f46e28112eec8a880683d",
    "last_modified_timestamp" : 1760664780000,
    "name" : "基线",
    "creation_date_timestamp" : 1760664780000,
    "is_base_branch" : 1,
    "id" : "v90200010s1h6476",
    "creation_date" : "2025-10-17 09:33:00",
    "type" : "TestVersion",
    "region" : "roma-guian-2",
    "last_modified" : "2025-10-17 09:33:00",
    "last_modifier" : "a17801c5d15f46e28112eec8a880683d"
  } ]
}