全部产品

查询代码库提交历史

该接口用于查询代码库提交历史信息

请求方式GET/api/v4/projects/[ProjectId]/repository/commits

请求Action:ListRepositoryCommits

请求参数

参数名

类型

说明

是否必须

默认值

ProjectId

long

代码库 ID

RefName

string

分支名称、标签名称或提交版本

Page

long

页数,最小值为1

1

PageSize

long

每页条数,范围[1, 100]

20

Path

string

文件路径

Search

string

搜索关键字

ShowSignature

boolean

是否展示签名

false

返回 body :

{
   "RequestId": "",
   "Success":true,
   "Total": 1,
   "Result": [
  {
   "Id": "b022b4518194d8078c825990fd878838dafdaab2",
   "ShortId": "b022b451",
   "Title": "Delete file kq4wg8f1_new",
   "AuthorName": "xxxxxx",
   "AuthorEmail": "xxxxxxx@xxx.com",
   "CreatedAt": "2020-09-04T11:44:42+08:00",
   "Message": "Delete file kq4wg8f1_new",
   "AuthoredDate": "2020-09-04T11:44:42+08:00",
   "CommittedDate": "2020-09-04T11:44:42+08:00",
   "CommitterEmail": "xxxxxxx@xxx.com",
   "CommitterName": "xxxxxxx",
   "ParentIds": [
    "36f089ea679a45adaac5c882e2c19d2b2f96308e"
   ],
   "Signature": {
    "GpgKeyId": "",
    "VerificationStatus": ""
   }
  }
    ]
}

返回结果说明:

参数名

类型

说明

Id

string

commit SHA

ShortId

string

短 ID

Title

string

标题,提交的第一行内容

AuthorName

string

作者姓名

AuthorEmail

string

作者邮箱

CreatedAt

string

创建时间

Message

string

提交内容

AuthoredDate

string

作者提交时间

CommittedDate

string

提交者提交时间

CommitterEmail

string

提交者邮箱

CommitterName

string

提交者姓名

ParentIds

list

父提交 ID

Signature

struct

签名信息

-> GpgKeyId

string

GPG key ID

-> VerificationStatus

string

验证状态

  • unverified:未验证
  • verified:GPG公钥验证通过且邮箱一致
  • same_user_different_email:gpg公钥验签通过,提交者邮箱(CommitterEmail) 属于当前用户,但与证书邮箱不一致
  • other_user:gpg公钥验签通过,但提交者邮箱(committer_email) 不属于key的用户
  • unverified_key:key对应的邮箱,不在该用户的邮箱列表中
  • unknown_key:gpg key不存在