获取分支列表
功能介绍
获取分支列表
调用方法
请参见如何调用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
参数 |
参数类型 |
描述 |
---|---|---|
status |
String |
success|error |
error |
ApiError object |
错误信息 |
request_id |
String |
由接口调用方传入,建议使用UUID保证请求的唯一性。 |
server_address |
String |
本次请求的受理的服务地址 |
result |
详细结果 |
参数 |
参数类型 |
描述 |
---|---|---|
total |
Long |
总数 |
values |
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
{ "status" : "success", "result" : { "total" : 3, "values" : [ { "id" : "v92u000107oqjkf9", "number" : "0001", "type" : "TestVersion", "author" : "014735ce003a4cbf88f3fd6cf7120494", "name" : "版本2", "region" : "cn-north-7", "last_modifier" : "014735ce003a4cbf88f3fd6cf7120494", "last_modified" : "2025-06-18 11:28:37", "last_modified_timestamp" : 1750217317000, "last_change_time" : "2025-06-18 11:28:37", "version_id" : "ab26ad085a594c9baac38216dff3409c", "creation_version_id" : "ab26ad085a594c9baac38216dff3409c", "parent_id" : "ab26ad085a594c9baac38216dff3409c", "parent_path" : "/ab26ad085a594c9baac38216dff3409c/", "creation_date" : "2025-06-18 11:28:37", "creation_date_timestamp" : 1750217317000, "author_name" : "wangjing95777777777", "is_base_branch" : 0, "project_id" : "ab26ad085a594c9baac38216dff3409c", "comment" : "备注", "rank" : 1 }, { "id" : "v92u000107oqjkf9", "number" : "0001", "type" : "TestVersion", "author" : "014735ce003a4cbf88f3fd6cf7120494", "name" : "001", "region" : "cn-north-7", "last_modifier" : "014735ce003a4cbf88f3fd6cf7120494", "last_modified" : "2025-04-25 09:29:30", "last_modified_timestamp" : 1745544570000, "last_change_time" : "2025-04-25 09:29:30", "version_id" : "ab26ad085a594c9baac38216dff3409c", "creation_version_id" : "ab26ad085a594c9baac38216dff3409c", "parent_id" : "ab26ad085a594c9baac38216dff3409c", "parent_path" : "/ab26ad085a594c9baac38216dff3409c/", "creation_date" : "2025-04-25 09:29:30", "creation_date_timestamp" : 1745544570000, "author_name" : "wangjing95777777777", "is_base_branch" : 0, "project_id" : "ab26ad085a594c9baac38216dff3409c", "comment" : "备注", "rank" : 1 }, { "id" : "v92u000107oqjkf9", "number" : "0001", "type" : "TestVersion", "author" : "e8d27b5521a64fb28a8fd9c99cd66eb3", "name" : "基线", "region" : "cn-north-7", "last_modifier" : "e8d27b5521a64fb28a8fd9c99cd66eb3", "last_modified" : "2025-02-07 11:10:33", "last_modified_timestamp" : 1738897833000, "last_change_time" : "2025-02-07 11:10:33", "version_id" : "ab26ad085a594c9baac38216dff3409c", "creation_version_id" : "ab26ad085a594c9baac38216dff3409c", "parent_id" : "ab26ad085a594c9baac38216dff3409c", "parent_path" : "/ab26ad085a594c9baac38216dff3409c/", "creation_date" : "2025-02-07 11:10:33", "creation_date_timestamp" : 1738897833000, "author_name" : "paas_testplan_wwx1114369_01", "is_base_branch" : 1, "project_id" : "ab26ad085a594c9baac38216dff3409c", "comment" : "备注", "rank" : 1 } ] } }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
404 |
Not Found |
500 |
Internal Server Error |
错误码
请参见错误码。