그룹 Markdown 업로드 API

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

Markdown 업로드는 그룹에 업로드된 파일로, 에픽이나 위키 페이지의 Markdown 텍스트에서 참조될 수 있습니다.

업로드 목록

그룹의 모든 업로드를 created_at 기준으로 내림차순 정렬하여 가져옵니다.

이 엔드포인트를 사용하려면 최소한 Maintainer 역할이 필요합니다.

GET /groups/:id/uploads
속성 유형 필수 설명
id 정수 또는 문자열 예 그룹의 ID 또는 URL-인코딩된 경로입니다.

예제 요청:

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/uploads"

예제 응답:

[
  {
    "id": 1,
    "size": 1024,
    "filename": "image.png",
    "created_at":"2024-06-20T15:53:03.067Z",
    "uploaded_by": {
      "id": 18,
      "name" : "Alexandra Bashirian",
      "username" : "eileen.lowe"
    }
  },
  {
    "id": 2,
    "size": 512,
    "filename": "other-image.png",
    "created_at":"2024-06-19T15:53:03.067Z",
    "uploaded_by": null
  }
]

ID로 업로드된 파일 다운로드

이 엔드포인트를 사용하려면 최소한 Maintainer 역할이 필요합니다.

GET /groups/:id/uploads/:upload_id

지원되는 속성:

속성 유형 필수 설명
id 정수 또는 문자열 예 그룹의 ID 또는 URL-인코딩된 경로입니다.
upload_id 정수 예 업로드의 ID입니다.

예제 요청:

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/uploads/1"

성공하면 200을 반환하고 응답 본문에 업로드된 파일이 포함됩니다.

비밀과 파일 이름으로 업로드된 파일 다운로드

이 엔드포인트를 사용하려면 최소한 Guest 역할이 필요합니다.

GET /groups/:id/uploads/:secret/:filename

지원되는 속성:

속성 유형 필수 설명
id 정수 또는 문자열 예 그룹의 ID 또는 URL-인코딩된 경로입니다.
secret 문자열 예 업로드의 32자 비밀입니다.
filename 문자열 예 업로드의 파일 이름입니다.

예제 요청:

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/uploads/648d97c6eef5fc5df8d1004565b3ee5a/sample.jpg"

성공하면 200을 반환하고 응답 본문에 업로드된 파일이 포함됩니다.

업로드한 파일을 ID로 삭제하기

이 엔드포인트를 사용하려면 최소한 Maintainer 역할이 있어야 합니다.

DELETE /groups/:id/uploads/:upload_id

지원되는 속성:

속성 유형 필수 설명
id 정수 또는 문자열 예 그룹의 ID 또는 URL-인코딩된 경로.
upload_id 정수 예 업로드의 ID.

예제 요청:

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/uploads/1"

성공하면 응답 본문 없이 204 상태 코드를 반환합니다.

업로드한 파일을 비밀 및 파일 이름으로 삭제하기

이 엔드포인트를 사용하려면 최소한 Maintainer 역할이 있어야 합니다.

DELETE /groups/:id/uploads/:secret/:filename

지원되는 속성:

속성 유형 필수 설명
id 정수 또는 문자열 예 그룹의 ID 또는 URL-인코딩된 경로.
secret 문자열 예 업로드의 32자 비밀.
filename 문자열 예 업로드의 파일 이름.

예제 요청:

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/uploads/648d97c6eef5fc5df8d1004565b3ee5a/sample.jpg"

성공하면 응답 본문 없이 204 상태 코드를 반환합니다.