REST API 버전 2026-03-10이 이제 사용 가능합니다

Source: GitHub Changelog

이전에 우리는 REST API에 대해 캘린더 기반 버전 관리를 도입했습니다(관련 글. 이를 통해 API를 점진적으로 발전시키면서 통합자들에게 충분한 시간과 명확한 업그레이드 가이드를 제공할 수 있었습니다.

이제 2026-03-10 캘린더 버전을 출시합니다. 이는 GitHub REST API의 최신 버전이며, 파괴적 변경(breaking changes)이 포함된 최초의 캘린더 버전입니다.

이번 릴리스에 포함된 내용

버전 2026-03-10은 REST API에 일련의 파괴적 변경을 도입합니다. 전체 변경 목록과 업그레이드 가이드는 우리의 파괴적 변경 문서에서 확인할 수 있습니다.

참고로, 비파괴적 변경(예: 새로운 엔드포인트, 선택적 매개변수, 추가 응답 필드)은 지원되는 모든 API 버전에서 계속 사용할 수 있습니다.

기존 통합에 미치는 영향

버전 2022-11-28은 오늘부터 최소 24개월 동안 완전히 지원될 것이며, X-GitHub-Api-Version 헤더가 포함되지 않은 요청은 계속해서 기본값인 2022-11-28을 사용합니다.

업그레이드 준비가 되면 절차는 간단합니다. 새 버전 문서를 검토하고 파괴적 변경에 대응하기 위해 통합 코드를 수정한 뒤, X-GitHub-Api-Version 헤더를 2026-03-10으로 업데이트하고 새로운 API 버전에서 통합이 정상적으로 동작하는지 확인하면 됩니다.

우리의 API 문서에서 버전 선택기를 사용하면 모든 사용 가능한 버전의 문서를 확인할 수 있습니다.

앞으로의 계획

앞으로도 GitHub changelog를 통해 새로운 API 버전 출시 소식을 지속적으로 전달할 예정입니다.

통합자들이 2026-03-10을 채택하여 최신 개선 사항과 기능을 활용해 주시면 좋겠습니다. 즉시 업그레이드해야 한다는 압박은 없지만, 새 버전으로 전환하면 통합이 호환성을 유지하고 향후 지속적인 개선 혜택을 받을 수 있습니다.