获取分支列表 - ListTesthubBranches
功能介绍
此接口用户获取项目下的所有分支列表
测试 -> 测试用例 -> 上方分支右侧小齿轮
调用方法
请参见如何调用API。
URI
GET /v4/testhub/projects/{project_id}/branches
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
sort_field |
否 |
String |
排序字段 |
|
sort_type |
否 |
String |
参数解释: 排序方式 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
|
offset |
是 |
Integer |
起始偏移 |
|
limit |
是 |
Integer |
页大小 |
请求参数
无
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
value |
Array of ExternalBrancVersionVo objects |
详细结果 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
type |
String |
参数解释: 资源类型 取值范围:
|
|
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
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
接口调用失败错误码 |
|
error_msg |
String |
接口调用失败错误信息 |
状态码：401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
接口调用失败错误码 |
|
error_msg |
String |
接口调用失败错误信息 |
状态码：404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
接口调用失败错误码 |
|
error_msg |
String |
接口调用失败错误信息 |
状态码：500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
接口调用失败错误码 |
|
error_msg |
String |
接口调用失败错误信息 |
请求示例
get https://{endpoint}/v4/testhub/projects/ab26ad085a594c9baac38216dff3409c/branches
响应示例
状态码：200
OK
{
"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"
} ]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
404 |
Not Found |
|
500 |
Internal Server Error |
错误码
请参见错误码。
