文档首页/ 代码托管 CodeArts Repo/ API参考/ API/ V4/ MergeRequest/ 获取合并请求commit列表
更新时间：2025-07-15 GMT+08:00
查看PDF
分享

获取合并请求commit列表

功能介绍

获取合并请求commit列表

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v4/repositories/{repository_id}/merge-requests/{merge_request_iid}/commits

表1 路径参数

参数

是否必选

参数类型

描述

repository_id

是

Integer

参数解释：

仓库的ID，通过查询用户所有仓库接口查询项目列表获取。

约束限制：

不涉及。

取值范围：

1-2147483647

merge_request_iid

是

Integer

参数解释：

合并请求 iid。

取值范围：

1-2147483647
表2 Query参数

参数

是否必选

参数类型

描述

view

否

String

参数解释：

是否以简单模式展示commit，传值为simple时以简单模式展示，否则正常展示。

**约束限制 **

  • simple, 以简单模式展示commit。

枚举值：

  • simple

offset

否

Integer

参数解释：

偏移量，从0开始。

取值范围：

0-2147483647

默认取值：

0

limit

否

Integer

参数解释：

返回数量。

取值范围：

1-100

默认取值：

20

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

必传。

取值范围：

字符串长度不少于1，不超过10万。

默认取值：

不涉及。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

[数组元素]

Array of MergeRequestCommitDto objects

合并请求commit列表详情
表5 MergeRequestCommitDto

参数

参数类型

描述

id

String

commit id

short_id

String

commit 短id

title

String

提交标题

message

String

提交信息

author_name

String

commit 作者名称

name

String

用户名

user_name

String

用户名

tenant_name

String

租户名

nick_name

String

昵称

authored_date

String

最初commit 提交日期（本地提交日期）

committed_date

String

commit提交日期（推送至仓库日期）

committer_name

String

commit 提交者名称

gpg_primary_key_id

String

pgp key id

open_gpg_verified

Boolean

gpg公钥验证是否开启

verification_status

Boolean

gpg公钥验证是否通过

parent_ids

Array of strings

提交父commit节点

created_at

String

commit 数据库记录创建时间

状态码：400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

error_msg

String

参数解释：

错误信息。

状态码：401

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

error_msg

String

参数解释：

错误信息。

请求示例

无

响应示例

状态码：200

OK

{
  "id" : "c31a08bc85418c82f96e70fed197781ad62d3891",
  "short_id" : "c31a08bc",
  "title" : "更新 dev",
  "message" : "更新 dev",
  "author_name" : "example_name",
  "name" : "example.com",
  "user_name" : "example_name",
  "tenant_name" : "example_name",
  "nick_name" : "example_name",
  "authored_date" : "2024-12-18T16:09:26.000+08:00",
  "committed_date" : "2024-12-18T16:09:26.000+08:00",
  "committer_name" : "2024-12-18T16:09:26.000+08:00",
  "gpg_primary_key_id" : "87E44B5F42161434",
  "open_gpg_verified" : true,
  "verification_status" : 1,
  "parent_ids" : [ "ee792e378901e39008c6cbdd5bf01b056ba56e9b" ],
  "created_at" : "2024-12-18T16:09:26.000+08:00"
}

状态码：400

Bad Request

{
  "error_code" : "CH.00405011",
  "error_msg" : "错误请求"
}

状态码：401

Unauthorized

{
  "error_code" : "DEV.00000003",
  "error_msg" : "认证信息过期"
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

错误码

请参见错误码。

父主题： MergeRequest

相关文档