更新时间:2025-08-26 GMT+08:00
分享

获取git-code代码仓分支

功能介绍

获取git-code代码仓分支

调用方法

请参见如何调用API

URI

GET /v1/code/git-code/{endpoint_id}/branches

表1 路径参数

参数

是否必选

参数类型

描述

endpoint_id

String

参数解释

拓展点id。

约束限制

不涉及。

取值范围

数字、小写字母组合。

表2 Query参数

参数

是否必选

参数类型

描述

page

Integer

参数解释

分页页码, 表示从此页开始查询。

约束限制

不涉及。

取值范围

page大于等于1。

默认取值:

1

page_size

Integer

参数解释

每页显示的条目数量。

约束限制

正整数。

取值范围

page_size小于等于100。

默认取值:

10

search

String

参数解释

查询过滤条件。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

repo_id

String

参数解释

代码仓ID,使用codehub必填。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

limit

Integer

参数解释

每页显示的条目数量,limit小于等于100。

约束限制

不涉及。

取值范围

只能使用数字,小于等于100。

默认取值:

10

offset

Integer

参数解释

分页页码,表示从此页开始查询。

约束限制

不涉及。

取值范围

只能使用数字,大于等于0。

默认取值:

0

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

result

Array of GitCodeBranch objects

结果

error

String

返回错误信息

status

String

返回状态信息

表4 GitCodeBranch

参数

参数类型

描述

name

String

参数解释

分支名称。

约束限制

不涉及。

取值范围

不涉及。

commit

commit object

提交记录

表5 commit

参数

参数类型

描述

id

String

参数解释

提交记录id。

约束限制

不涉及。

取值范围

不涉及。

title

String

参数解释

提交记录标题。

约束限制

不涉及。

取值范围

不涉及。

message

String

参数解释

描述信息。

约束限制

不涉及。

取值范围

不涉及。

created_at

String

参数解释

创建时间。

约束限制

不涉及。

取值范围

不涉及。

author_name

String

参数解释

修改人。

约束限制

不涉及。

取值范围

不涉及。

committer_name

String

参数解释

提交人。

约束限制

不涉及。

取值范围

不涉及。

committed_date

String

参数解释

提交时间。

约束限制

不涉及。

取值范围

不涉及。

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码:401

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码:403

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码:404

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码:500

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

GET https://{endpoint}/v1/code/git-code/{endpoint_id}/branches

响应示例

状态码:200

OK

{
  "result" : [ {
    "name" : "main",
    "commit" : {
      "id" : 12,
      "title" : "修改xxx问题",
      "message" : "修改xxx类",
      "created_at" : "2024-01-01 12:00:00",
      "author_name" : "test1",
      "committer_name" : "test2",
      "committed_date" : "2024-01-01 12:00:00"
    }
  }, {
    "name" : "master",
    "commit" : null
  } ],
  "error" : null,
  "status" : "success"
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档