Skip to main content

API 버전

REST API를 요청할 때마다 사용할 REST API 버전을 지정하는 방법을 알아봅니다.

API 버전 관리 정보

데이터 재사용.rest-api.api-버전-정보 %}

API 버전 지정

          `X-GitHub-Api-Version` 헤더를 사용하여 API 버전을 지정해야 합니다. 예시:
curl --header "X-GitHub-Api-Version:2026-03-10" https://api.github.com/zen
          `X-GitHub-Api-Version` 헤더가 없는 요청은 기본적으로 `2022-11-28` 버전을 사용합니다.

더 이상 지원되지 않는 API 버전을 지정하면 400 오류가 발생합니다.

새 API 버전으로 업그레이드

새 REST API 버전으로 업그레이드하기 전에 새 API 버전에 해당하는 호환성이 손상되는 변경을 확인하고 포함된 호환성이 손상되는 변경 내용을 이해하고 해당 특정 API 버전으로 업그레이드하는 방법에 대해 자세히 알아봅니다. 자세한 내용은 주요 변경사항을(를) 참조하세요.

          `X-GitHub-Api-Version` 헤더에서 새 API 버전을 지정하도록 통합을 업데이트하는 경우 새 API 버전과 함께 작동하려면 통합에 필요한 변경 내용도 변경해야 합니다.

통합이 업데이트되면 통합을 테스트하여 새 API 버전에서 작동하는지 확인합니다.

지원되는 API 버전

현재 지원되는 REST API 버전은 다음과 같습니다.

2026-03-10 2022-11-28

API 요청을 만들어 지원되는 모든 API 버전을 가져올 수도 있습니다. 자세한 내용은 메타 데이터에 대한 REST API 엔드포인트을(를) 참조하세요.