그룹 배지 API

GitLab 그룹 배지를 관리하기 위한 API 엔드포인트를 설명합니다.

이 API를 사용하여 그룹 배지를 관리합니다. 자세한 내용은 그룹 배지 를 참조하세요. 배지는 링크와 이미지 URL 모두에서 실시간으로 대체되는 자리표시자를 지원합니다. 다음 자리표시자를 사용할 수 있습니다: %{project_path} : 프로젝트 경로로 대체됩니다. %{project_title} : 프로젝트 제목으로 대체됩니다. %{project_name} : 프로젝트 이름으로 대체됩니다. %{project_id} : 프로젝트 ID로 대체됩니다. %{project_namespace} : 프로젝트의 네임스페이스 전체 경로로 대체됩니다. %{group_name} : 프로젝트의 최상위 그룹 이름으로 대체됩니다. %{gitlab_server} : 프로젝트의 서버 이름으로 대체됩니다. %{gitlab_pages_domain} : GitLab Pages를 호스팅하는 도메인 이름으로 대체됩니다. %{default_branch} : 프로젝트 기본 브랜치로 대체됩니다. %{commit_sha} : 프로젝트의 마지막 커밋 SHA로 대체됩니다. %{latest_tag} : 프로젝트의 마지막 태그로 대체됩니다. 이러한 엔드포인트는 프로젝트의 컨텍스트 내에 있지 않으므로, 자리표시자를 대체하는 데 사용되는 정보는 생성 날짜 기준으로 첫 번째 그룹의 프로젝트에서 가져옵니다. 그룹에 프로젝트가 없는 경우 자리표시자가 있는 원래 URL이 반환됩니다. 모든 그룹 배지 목록 # 지정된 그룹의 배지를 나열합니다. GET /groups/:id/badges 속성 유형 필수 설명 id integer 또는 string 예 그룹의 ID 또는 URL 인코딩된 경로 name string 아니오 반환할 배지의 이름(대소문자 구분). curl \ --header "PRIVATE-TOKEN: <your_access_token>" \ --url "https://gitlab.example.com/api/v4/groups/:id/badges?name=Coverage" 응답 예시: [ { "name" : "Coverage" , "id" : 1 , "link_url" : "http://example.com/ci_status.svg?project=%{project_path}&ref=%{default_branch}" , "image_url" : "https://shields.io/my/badge" , "rendered_link_url" : "http://example.com/ci_status.svg?project=example-org/example-project&ref=main" , "rendered_image_url" : "https://shields.io/my/badge" , "kind" : "group" } ] 그룹 배지 조회 # 그룹의 지정된 배지를 조회합니다. GET /groups/:id/badges/:badge_id 속성 유형 필수 설명 id integer 또는 string 예 그룹의 ID 또는 URL 인코딩된 경로 badge_id integer 예 배지 ID