이 API를 사용하여 Git 커밋을 관리합니다.

응답#

이 API의 응답에서 일부 날짜 필드는 중복된 정보처럼 보일 수 있습니다.

• created_at 필드는 다른 GitLab API와의 일관성을 위해서만 존재합니다. 이 필드는 항상 committed_date 필드와 동일합니다.

• committed_date와 authored_date 필드는 서로 다른 소스에서 생성되므로 동일하지 않을 수 있습니다.

페이지네이션 응답 헤더#

성능상의 이유로 GitLab은 Commits API 응답에서 다음 헤더를 반환하지 않습니다.

• x-total

• x-total-pages

자세한 내용은 이슈 389582를 참조하세요.

리포지터리 커밋 목록 조회#

히스토리

• GitLab 18.10에서 follow가 도입됨.

프로젝트의 리포지터리 커밋 목록을 가져옵니다.

GET /projects/:id/repository/commits

성공 시 200 OK와 다음 응답 속성을 반환합니다.

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits"

응답 예시:

[
  {
    "id": "ed899a2f4b50b4370feeea94676502b42383c746",
    "short_id": "ed899a2f4b5",
    "title": "Replace sanitize with escape once",
    "author_name": "Example User",
    "author_email": "user@example.com",
    "authored_date": "2021-09-20T11:50:22.001+00:00",
    "committer_name": "Administrator",
    "committer_email": "admin@example.com",
    "committed_date": "2021-09-20T11:50:22.001+00:00",
    "created_at": "2021-09-20T11:50:22.001+00:00",
    "message": "Replace sanitize with escape once",
    "parent_ids": [
      "6104942438c14ec7bd21c6cd5bd995272b3faff6"
    ],
    "web_url": "https://gitlab.example.com/janedoe/gitlab-foss/-/commit/ed899a2f4b50b4370feeea94676502b42383c746",
    "trailers": {},
    "extended_trailers": {}
  },
  {
    "id": "6104942438c14ec7bd21c6cd5bd995272b3faff6",
    "short_id": "6104942438c",
    "title": "Sanitize for network graph",
    "author_name": "randx",
    "author_email": "user@example.com",
    "committer_name": "ExampleName",
    "committer_email": "user@example.com",
    "created_at": "2021-09-20T09:06:12.201+00:00",
    "message": "Sanitize for network graph\nCc: John Doe <johndoe@gitlab.com>\nCc: Jane Doe <janedoe@gitlab.com>",
    "parent_ids": [
      "ae1d9fb46aa2b07ee9836d49862ec4e2c46fbbba"
    ],
    "web_url": "https://gitlab.example.com/janedoe/gitlab-foss/-/commit/ed899a2f4b50b4370feeea94676502b42383c746",
    "trailers": {
      "Cc": "Jane Doe <janedoe@gitlab.com>"
    },
    "extended_trailers": {
      "Cc": [
        "John Doe <johndoe@gitlab.com>",
        "Jane Doe <janedoe@gitlab.com>"
      ]
    }
  }
]

커밋 생성#

히스토리

• GitLab 18.8에서 allow_empty가 도입됨.

• GitLab 18.7에서 요청 크기 및 속도 제한이 도입됨.

JSON 페이로드를 게시하여 커밋을 생성합니다.

POST /projects/:id/repository/commits

이 엔드포인트는 요청 크기 및 속도 제한의 적용을 받습니다. 기본 300 MB 제한보다 큰 요청은 거부됩니다. 20 MB를 초과하는 요청은 30초마다 3회의 요청으로 속도가 제한됩니다.

각주:

• force가 true이면, 다른 부모 커밋을 지정하기 위해 start_branch 또는 start_sha를 제공하세요. 어느 것도 제공하지 않으면 start_branch는 branch의 값으로 기본 설정되며, 새 커밋은 현재 브랜치 팁을 기반으로 합니다. 이 경우 결과가 일반 커밋과 동일하므로 force는 효과가 없습니다.

많은 action이 포함된 대용량 요청은 크기 제한의 적용을 받을 수 있습니다. 자세한 내용은 커밋 API 제한을 참조하세요.

성공 시 201 Created와 다음 응답 속성을 반환합니다.

PAYLOAD=$(cat << 'JSON'
{
  "branch": "main",
  "commit_message": "some commit message",
  "actions": [
    {
      "action": "create",
      "file_path": "foo/bar",
      "content": "some content"
    },
    {
      "action": "delete",
      "file_path": "foo/bar2"
    },
    {
      "action": "move",
      "file_path": "foo/bar3",
      "previous_path": "foo/bar4",
      "content": "some content"
    },
    {
      "action": "update",
      "file_path": "foo/bar5",
      "content": "new content"
    },
    {
      "action": "chmod",
      "file_path": "foo/bar5",
      "execute_filemode": true
    }
  ]
}
JSON
)
curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --header "Content-Type: application/json" \
  --data "$PAYLOAD" \
  --url "https://gitlab.example.com/api/v4/projects/1/repository/commits"

응답 예시:

{
  "id": "ed899a2f4b50b4370feeea94676502b42383c746",
  "short_id": "ed899a2f4b5",
  "title": "some commit message",
  "author_name": "Example User",
  "author_email": "user@example.com",
  "committer_name": "Example User",
  "committer_email": "user@example.com",
  "created_at": "2016-09-20T09:26:24.000-07:00",
  "message": "some commit message",
  "parent_ids": [
    "ae1d9fb46aa2b07ee9836d49862ec4e2c46fbbba"
  ],
  "committed_date": "2016-09-20T09:26:24.000-07:00",
  "authored_date": "2016-09-20T09:26:24.000-07:00",
  "stats": {
    "additions": 2,
    "deletions": 2,
    "total": 4
  },
  "status": null,
  "web_url": "https://gitlab.example.com/janedoe/gitlab-foss/-/commit/ed899a2f4b50b4370feeea94676502b42383c746"
}

GitLab은 폼 인코딩을 지원합니다. 다음은 폼 인코딩을 사용한 Commit API 예시입니다.

curl --request POST \
     --form "branch=main" \
     --form "commit_message=some commit message" \
     --form "start_branch=main" \
     --form "actions[][action]=create" \
     --form "actions[][file_path]=foo/bar" \
     --form "actions[][content]=</path/to/local.file" \
     --form "actions[][action]=delete" \
     --form "actions[][file_path]=foo/bar2" \
     --form "actions[][action]=move" \
     --form "actions[][file_path]=foo/bar3" \
     --form "actions[][previous_path]=foo/bar4" \
     --form "actions[][content]=</path/to/local1.file" \
     --form "actions[][action]=update" \
     --form "actions[][file_path]=foo/bar5" \
     --form "actions[][content]=</path/to/local2.file" \
     --form "actions[][action]=chmod" \
     --form "actions[][file_path]=foo/bar5" \
     --form "actions[][execute_filemode]=true" \
     --header "PRIVATE-TOKEN: <your_access_token>" \
     --url "https://gitlab.example.com/api/v4/projects/1/repository/commits"

커밋 조회#

커밋 해시 또는 브랜치나 태그 이름으로 식별된 특정 커밋을 가져옵니다.

GET /projects/:id/repository/commits/:sha

파라미터:

성공 시 200 OK와 다음 응답 속성을 반환합니다.

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/main"

응답 예시:

{
  "id": "6104942438c14ec7bd21c6cd5bd995272b3faff6",
  "short_id": "6104942438c",
  "title": "Sanitize for network graph",
  "author_name": "randx",
  "author_email": "user@example.com",
  "committer_name": "Dmitriy",
  "committer_email": "user@example.com",
  "created_at": "2021-09-20T09:06:12.300+03:00",
  "message": "Sanitize for network graph",
  "committed_date": "2021-09-20T09:06:12.300+03:00",
  "authored_date": "2021-09-20T09:06:12.420+03:00",
  "parent_ids": [
    "ae1d9fb46aa2b07ee9836d49862ec4e2c46fbbba"
  ],
  "last_pipeline": {
    "id": 8,
    "ref": "main",
    "sha": "2dc6aa325a317eda67812f05600bdf0fcdc70ab0",
    "status": "created"
  },
  "stats": {
    "additions": 15,
    "deletions": 10,
    "total": 25
  },
  "status": "running",
  "web_url": "https://gitlab.example.com/janedoe/gitlab-foss/-/commit/6104942438c14ec7bd21c6cd5bd995272b3faff6"
}

커밋이 푸시된 모든 참조 목록 조회#

커밋이 푸시된 모든 참조(브랜치 또는 태그)를 나열합니다. 페이지네이션 파라미터 page와 per_page를 사용하여 참조 목록을 제한할 수 있습니다.

GET /projects/:id/repository/commits/:sha/refs

파라미터:

성공 시 200 OK와 다음 응답 속성을 반환합니다.

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/5937ac0a7beb003549fc5fd26fc247adbce4a52e/refs?type=all"

응답 예시:

[
  {
    "type": "branch",
    "name": "'test'"
  },
  {
    "type": "branch",
    "name": "add-balsamiq-file"
  },
  {
    "type": "branch",
    "name": "wip"
  },
  {
    "type": "tag",
    "name": "v1.1.0"
  }
]

커밋 시퀀스 조회#

히스토리

• GitLab 16.9에서 도입됨.

주어진 커밋으로부터 부모 링크를 따라가며 프로젝트에서 커밋의 시퀀스 번호를 가져옵니다.

이 API는 주어진 커밋 SHA에 대해 git rev-list --count 명령과 본질적으로 동일한 기능을 제공합니다.

GET /projects/:id/repository/commits/:sha/sequence

파라미터:

성공 시 200 OK와 다음 응답 속성을 반환합니다.

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/5937ac0a7beb003549fc5fd26fc247adbce4a52e/sequence"

응답 예시:

{
  "count": 632
}

커밋 Cherry-pick#

커밋을 특정 브랜치에 cherry-pick합니다.

POST /projects/:id/repository/commits/:sha/cherry_pick

파라미터:

성공 시 201 Created와 다음 응답 속성을 반환합니다.

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --form "branch=main" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/main/cherry_pick"

응답 예시:

{
  "id": "8b090c1b79a14f2bd9e8a738f717824ff53aebad",
  "short_id": "8b090c1b",
  "author_name": "Example User",
  "author_email": "user@example.com",
  "authored_date": "2016-12-12T20:10:39.000+01:00",
  "created_at": "2016-12-12T20:10:39.000+01:00",
  "committer_name": "Administrator",
  "committer_email": "admin@example.com",
  "committed_date": "2016-12-12T20:10:39.000+01:00",
  "title": "Feature added",
  "message": "Feature added\n\nSigned-off-by: Example User <user@example.com>\n",
  "parent_ids": [
    "a738f717824ff53aebad8b090c1b79a14f2bd9e8"
  ],
  "web_url": "https://gitlab.example.com/janedoe/gitlab-foss/-/commit/8b090c1b79a14f2bd9e8a738f717824ff53aebad"
}

cherry-pick이 실패하는 경우, 응답은 실패 이유에 대한 컨텍스트를 제공합니다.

{
  "message": "Sorry, we cannot cherry-pick this commit automatically. This commit may already have been cherry-picked, or a more recent commit may have updated some of its content.",
  "error_code": "empty"
}

이 경우, 변경 세트가 비어 있어 cherry-pick이 실패했으며, 커밋이 이미 타깃 브랜치에 존재할 가능성이 높습니다. 다른 가능한 오류 코드는 conflict로, 머지 충돌이 발생했음을 나타냅니다.

dry_run이 활성화된 경우, 서버는 cherry-pick 적용을 시도하지만 실제로 변경 사항을 커밋하지는 않습니다. cherry-pick이 문제없이 적용되면 API는 200 OK로 응답합니다.

{
  "dry_run": "success"
}

실패 시에는 dry run 없이 실패하는 경우와 동일한 오류가 표시됩니다.

커밋 Revert#

특정 브랜치에서 커밋을 revert합니다.

POST /projects/:id/repository/commits/:sha/revert

파라미터:

성공 시 201 Created와 다음 응답 속성을 반환합니다.

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --form "branch=main" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/a738f717824ff53aebad8b090c1b79a14f2bd9e8/revert"

응답 예시:

{
  "id": "8b090c1b79a14f2bd9e8a738f717824ff53aebad",
  "short_id": "8b090c1b",
  "title": "Revert \"Feature added\"",
  "created_at": "2018-11-08T15:55:26.000Z",
  "parent_ids": [
    "a738f717824ff53aebad8b090c1b79a14f2bd9e8"
  ],
  "message": "Revert \"Feature added\"\n\nThis reverts commit a738f717824ff53aebad8b090c1b79a14f2bd9e8",
  "author_name": "Administrator",
  "author_email": "admin@example.com",
  "authored_date": "2018-11-08T15:55:26.000Z",
  "committer_name": "Administrator",
  "committer_email": "admin@example.com",
  "committed_date": "2018-11-08T15:55:26.000Z",
  "web_url": "https://gitlab.example.com/janedoe/gitlab-foss/-/commit/8b090c1b79a14f2bd9e8a738f717824ff53aebad"
}

revert가 실패하는 경우, 응답은 실패 이유에 대한 컨텍스트를 제공합니다.

{
  "message": "Sorry, we cannot revert this commit automatically. This commit may already have been reverted, or a more recent commit may have updated some of its content.",
  "error_code": "conflict"
}

이 경우, revert 시도 중 머지 충돌이 발생하여 revert가 실패했습니다. 다른 가능한 오류 코드는 empty로, 변경 세트가 비어 있어 변경이 이미 revert되었을 가능성이 높음을 나타냅니다.

dry_run이 활성화된 경우, 서버는 revert 적용을 시도하지만 실제로 변경 사항을 커밋하지는 않습니다. revert가 문제없이 적용되면 API는 200 OK로 응답합니다.

{
  "dry_run": "success"
}

실패 시에는 dry run 없이 실패하는 경우와 동일한 오류가 표시됩니다.

커밋 diff 조회#

히스토리

• GitLab 18.4에서 collapsed 및 too_large 응답 속성이 도입됨.

프로젝트에서 커밋의 diff를 가져옵니다.

GET /projects/:id/repository/commits/:sha/diff

파라미터:

이 엔드포인트는 diff 제한의 적용을 받습니다. 커밋이 설정된 최대 파일 수를 초과하면 페이지네이션이 중지되고 제한을 초과하는 추가 파일은 반환되지 않습니다. GitLab.com 특정 제한에 대해서는 diff 표시 제한을 참조하세요.

성공 시 200 OK와 다음 응답 속성을 반환합니다.

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/main/diff"

응답 예시:

[
  {
    "diff": "@@ -71,6 +71,8 @@\n sudo -u git -H bundle exec rake migrate_keys RAILS_ENV=production\n sudo -u git -H bundle exec rake migrate_inline_notes RAILS_ENV=production\n \n+sudo -u git -H bundle exec rake gitlab:assets:compile RAILS_ENV=production\n+\n ```\n \n ### 6. Update config files",
    "collapsed": false,
    "too_large": false,
    "new_path": "doc/update/5.4-to-6.0.md",
    "old_path": "doc/update/5.4-to-6.0.md",
    "a_mode": null,
    "b_mode": "100644",
    "new_file": false,
    "renamed_file": false,
    "deleted_file": false
  }
]

모든 커밋 코멘트 목록 조회#

프로젝트에서 커밋의 모든 코멘트를 나열합니다.

GET /projects/:id/repository/commits/:sha/comments

파라미터:

성공 시 200 OK와 다음 응답 속성을 반환합니다.

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/main/comments"

응답 예시:

[
  {
    "note": "this code is really nice",
    "author": {
      "id": 11,
      "username": "admin",
      "email": "admin@local.host",
      "name": "Administrator",
      "state": "active",
      "created_at": "2014-03-06T08:17:35.000Z"
    }
  }
]

커밋에 코멘트 게시#

커밋에 코멘트를 생성합니다.

특정 파일의 특정 줄에 코멘트를 게시하려면 전체 커밋 SHA, path, line을 지정해야 하며 line_type은 new여야 합니다.

다음 중 하나라도 유효한 경우 코멘트는 마지막 커밋의 끝에 추가됩니다.

• sha가 브랜치 또는 태그이고 line 또는 path가 유효하지 않은 경우

• line 번호가 유효하지 않은 경우(존재하지 않음)

• path가 유효하지 않은 경우(존재하지 않음)

위의 경우 중 어느 하나에 해당하면, 응답의 line, line_type 및 path는 null로 설정됩니다.

머지 리퀘스트에 코멘트를 달기 위한 다른 방법은 노트 API의 머지 리퀘스트 노트 생성과 discussions API의 머지 리퀘스트 diff에서 새 스레드 생성을 참조하세요.

POST /projects/:id/repository/commits/:sha/comments

성공 시 201 Created와 다음 응답 속성을 반환합니다.

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --form "note=Nice picture\!" \
  --form "path=README.md" \
  --form "line=11" \
  --form "line_type=new" \
  --url "https://gitlab.example.com/api/v4/projects/17/repository/commits/18f3e63d05582537db6d183d9d557be09e1f90c8/comments"

응답 예시:

{
  "author": {
    "web_url": "https://gitlab.example.com/janedoe",
    "avatar_url": "https://gitlab.example.com/uploads/user/avatar/28/jane-doe-400-400.png",
    "username": "janedoe",
    "state": "active",
    "name": "Jane Doe",
    "id": 28
  },
  "created_at": "2016-01-19T09:44:55.600Z",
  "line_type": "new",
  "path": "README.md",
  "line": 11,
  "note": "Nice picture!"
}

모든 커밋 토론 목록 조회#

프로젝트에서 커밋의 모든 토론을 나열합니다.

GET /projects/:id/repository/commits/:sha/discussions

파라미터:

성공 시 200 OK와 다음 응답 속성을 반환합니다.

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/4604744a1c64de00ff62e1e8a6766919923d2b41/discussions"

응답 예시:

[
  {
    "id": "4604744a1c64de00ff62e1e8a6766919923d2b41",
    "individual_note": true,
    "notes": [
      {
        "id": 334686748,
        "type": null,
        "body": "Nice piece of code!",
        "attachment": null,
        "author": {
          "id": 28,
          "name": "Jane Doe",
          "username": "janedoe",
          "web_url": "https://gitlab.example.com/janedoe",
          "state": "active",
          "avatar_url": "https://gitlab.example.com/uploads/user/avatar/28/jane-doe-400-400.png"
        },
        "created_at": "2020-04-30T18:48:11.432Z",
        "updated_at": "2020-04-30T18:48:11.432Z",
        "system": false,
        "noteable_id": null,
        "noteable_type": "Commit",
        "resolvable": false,
        "confidential": null,
        "noteable_iid": null,
        "commands_changes": {}
      }
    ]
  }
]

커밋 상태#

GitLab과 함께 사용하는 커밋 상태 API입니다.

커밋 상태 목록 조회#

히스토리

• GitLab 17.9에서 pipeline_id, order_by, sort 필드가 도입됨.

프로젝트에서 커밋의 상태를 나열합니다. 페이지네이션 파라미터 page와 per_page를 사용하여 참조 목록을 제한할 수 있습니다.

GET /projects/:id/repository/commits/:sha/statuses

성공 시 200 OK와 다음 응답 속성을 반환합니다.

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/17/repository/commits/18f3e63d05582537db6d183d9d557be09e1f90c8/statuses"

응답 예시:

[
  ...
  {
    "status": "pending",
    "created_at": "2016-01-19T08:40:25.934Z",
    "started_at": null,
    "name": "bundler:audit",
    "allow_failure": true,
    "author": {
      "username": "janedoe",
      "state": "active",
      "web_url": "https://gitlab.example.com/janedoe",
      "avatar_url": "https://gitlab.example.com/uploads/user/avatar/28/jane-doe-400-400.png",
      "id": 28,
      "name": "Jane Doe"
    },
    "description": null,
    "sha": "18f3e63d05582537db6d183d9d557be09e1f90c8",
    "target_url": "https://gitlab.example.com/janedoe/gitlab-foss/builds/91",
    "finished_at": null,
    "id": 91,
    "ref": "main"
  },
  {
    "started_at": null,
    "name": "test",
    "allow_failure": false,
    "status": "pending",
    "created_at": "2016-01-19T08:40:25.832Z",
    "target_url": "https://gitlab.example.com/janedoe/gitlab-foss/builds/90",
    "id": 90,
    "finished_at": null,
    "ref": "main",
    "sha": "18f3e63d05582537db6d183d9d557be09e1f90c8",
    "author": {
      "id": 28,
      "name": "Jane Doe",
      "username": "janedoe",
      "web_url": "https://gitlab.example.com/janedoe",
      "state": "active",
      "avatar_url": "https://gitlab.example.com/uploads/user/avatar/28/jane-doe-400-400.png"
    },
    "description": null
  }
  ...
]

커밋 파이프라인 상태 설정#

external Stage의 job으로 표현되는 커밋의 상태를 추가하거나 업데이트합니다. 커밋이 머지 리퀘스트와 연결된 경우, 머지 리퀘스트의 소스 브랜치에 있는 커밋을 타깃으로 지정합니다.

커밋 상태를 설정하면:

• 기존 파이프라인을 먼저 검색하여 job을 추가합니다.

• 적합한 파이프라인이 없으면 CI_PIPELINE_SOURCE: external로 새 파이프라인이 생성됩니다.

자세한 내용은 외부 커밋 상태를 참조하세요.

동일한 커밋에 중복 파이프라인이 있는 경우, 어느 파이프라인이 외부 상태를 받는지 모호할 수 있습니다. 파이프라인을 구성하여 중복을 방지하세요.

파이프라인이 이미 존재하고 단일 파이프라인의 최대 job 수 제한을 초과하는 경우:

• pipeline_id가 지정된 경우 422 오류가 반환됩니다: The number of jobs has exceeded the limit.

• 그렇지 않으면 새 파이프라인이 생성됩니다.

SHA/ref 조합에 대한 업데이트가 이미 진행 중인 경우 409 오류가 반환됩니다. 이 오류를 처리하려면 요청을 재시도하세요.

POST /projects/:id/statuses/:sha

성공 시 201 Created와 다음 응답 속성을 반환합니다.

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/17/statuses/18f3e63d05582537db6d183d9d557be09e1f90c8?state=success"

응답 예시:

{
  "author": {
    "web_url": "https://gitlab.example.com/janedoe",
    "name": "Jane Doe",
    "avatar_url": "https://gitlab.example.com/uploads/user/avatar/28/jane-doe-400-400.png",
    "username": "janedoe",
    "state": "active",
    "id": 28
  },
  "name": "default",
  "sha": "18f3e63d05582537db6d183d9d557be09e1f90c8",
  "status": "success",
  "coverage": 100.0,
  "description": null,
  "id": 93,
  "target_url": null,
  "ref": null,
  "started_at": null,
  "created_at": "2016-01-19T09:05:50.355Z",
  "allow_failure": false,
  "finished_at": "2016-01-19T09:05:50.365Z"
}

커밋과 연결된 머지 리퀘스트 목록 조회#

히스토리

• GitLab 18.2에서 state 속성이 도입됨.

특정 커밋을 처음 도입한 머지 리퀘스트에 대한 정보를 반환합니다.

GET /projects/:id/repository/commits/:sha/merge_requests

성공 시 200 OK와 다음 응답 속성을 반환합니다.

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/af5b13261899fb2c0db30abdd0af8b07cb44fdc5/merge_requests?state=opened"

응답 예시:

[
  {
    "id": 45,
    "iid": 1,
    "project_id": 35,
    "title": "Add new file",
    "description": "",
    "state": "opened",
    "created_at": "2018-03-26T17:26:30.916Z",
    "updated_at": "2018-03-26T17:26:30.916Z",
    "target_branch": "main",
    "source_branch": "test-branch",
    "upvotes": 0,
    "downvotes": 0,
    "author": {
      "web_url": "https://gitlab.example.com/janedoe",
      "name": "Jane Doe",
      "avatar_url": "https://gitlab.example.com/uploads/user/avatar/28/jane-doe-400-400.png",
      "username": "janedoe",
      "state": "active",
      "id": 28
    },
    "assignee": null,
    "source_project_id": 35,
    "target_project_id": 35,
    "labels": [],
    "draft": false,
    "work_in_progress": false,
    "milestone": null,
    "merge_when_pipeline_succeeds": false,
    "merge_status": "can_be_merged",
    "sha": "af5b13261899fb2c0db30abdd0af8b07cb44fdc5",
    "merge_commit_sha": null,
    "squash_commit_sha": null,
    "user_notes_count": 0,
    "discussion_locked": null,
    "should_remove_source_branch": null,
    "force_remove_source_branch": false,
    "web_url": "https://gitlab.example.com/root/test-project/merge_requests/1",
    "time_stats": {
      "time_estimate": 0,
      "total_time_spent": 0,
      "human_time_estimate": null,
      "human_total_time_spent": null
    }
  }
]

커밋 서명 조회#

커밋이 서명된 경우 커밋의 서명을 가져옵니다. 서명되지 않은 커밋의 경우 404 응답이 반환됩니다.

GET /projects/:id/repository/commits/:sha/signature

파라미터:

성공 시 200 OK와 다음 응답 속성을 반환합니다.

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/1/repository/commits/da738facbc19eb2fc2cef57c49be0e6038570352/signature"

커밋이 GPG로 서명된 경우 응답 예시:

{
  "signature_type": "PGP",
  "verification_status": "verified",
  "gpg_key_id": 1,
  "gpg_key_primary_keyid": "8254AAB3FBD54AC9",
  "gpg_key_user_name": "John Doe",
  "gpg_key_user_email": "johndoe@example.com",
  "gpg_key_subkey_id": null,
  "commit_source": "gitaly"
}

커밋이 SSH로 서명된 경우 응답 예시:

{
  "signature_type": "SSH",
  "verification_status": "verified",
  "key": {
    "id": 11,
    "title": "Key",
    "created_at": "2023-05-08T09:12:38.503Z",
    "expires_at": "2024-05-07T00:00:00.000Z",
    "key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAILZzYDq6DhLp3aX84DGIV3F6Vf+Ae4yCTTz7RnqMJOlR MyKey)",
    "usage_type": "auth_and_signing"
  },
  "commit_source": "gitaly"
}

커밋이 X.509로 서명된 경우 응답 예시:

{
  "signature_type": "X509",
  "verification_status": "unverified",
  "x509_certificate": {
    "id": 1,
    "subject": "CN=gitlab@example.org,OU=Example,O=World",
    "subject_key_identifier": "BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC",
    "email": "gitlab@example.org",
    "serial_number": 278969561018901340486471282831158785578,
    "certificate_status": "good",
    "x509_issuer": {
      "id": 1,
      "subject": "CN=PKI,OU=Example,O=World",
      "subject_key_identifier": "AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB",
      "crl_url": "http://example.com/pki.crl"
    }
  },
  "commit_source": "gitaly"
}

커밋이 서명되지 않은 경우 응답 예시:

{
  "message": "404 GPG Signature Not Found"
}