{"meta":{"title":"重大な変更","intro":"各 REST API バージョンで導入された破壊的変更について説明します。","product":"REST API","breadcrumbs":[{"href":"/ja/enterprise-server@3.17/rest","title":"REST API"},{"href":"/ja/enterprise-server@3.17/rest/about-the-rest-api","title":"REST API について"},{"href":"/ja/enterprise-server@3.17/rest/about-the-rest-api/breaking-changes","title":"重大な変更"}],"documentType":"article"},"body":"# 重大な変更\n\n各 REST API バージョンで導入された破壊的変更について説明します。\n\n## REST API の破壊的変更について\n\nGitHub REST API はバージョン管理されています。 API バージョンの名前は、その API バージョンがリリースされた日付に基づいています。 たとえば、api バージョン `2026-03-10` は、 Tue, 10 Mar 2026でリリースされました。\n\n破壊的変更とは、統合を破損する可能性のある変更のことです。 破壊的変更は、新しい API バージョンでリリースされます。 破壊的変更をリリースする前に、事前通知を行います。 破壊的変更には次のようなものが含まれます。\n\n* 操作全体を削除する\n* パラメーターの削除または名前変更\n* 応答フィールドの削除または名前変更\n* 新しい必須パラメーターの追加\n* 以前に省略可能だったパラメーターを必須にする\n* パラメーターまたは応答フィールドの型の変更\n* 列挙型の値の削除\n* 既存のパラメーターへの新しい検証規則の追加\n* 認証または認可の要件の変更\n\n追加的な (破壊的でない) 変更は、サポートされているすべての API バージョンで使用できます。 追加的な変更とは、統合を破損しない変更のことです。 追加的な変更には次のようなものが含まれます。\n\n* 操作の追加\n* 省略可能なパラメーターの追加\n* 省略可能な要求ヘッダーの追加\n* 応答フィールドの追加\n* 応答ヘッダーの追加\n* 列挙型の値の追加\n\n新しい REST API バージョンがリリースされた場合、以前の API バージョンは、新しい API バージョンのリリースから少なくとも 24 か月間はサポートされます。\n\nAPI バージョンの詳細については、「[API のバージョン](/ja/enterprise-server@3.17/rest/about-the-rest-api/api-versions)」を参照してください。\n\n## 新しい API バージョンへのアップグレード\n\n新しい REST API バージョンにアップグレードする前に、新しい API バージョンに対応するこのページのセクションを読んで、どのような破壊的変更が含まれているかを理解し、その API バージョンにアップグレードする方法の詳細を確認する必要があります。\n\n`X-GitHub-Api-Version` ヘッダーで新しい API バージョンを指定するように統合を更新する場合は、統合が新しい API バージョンで動作するために必要な変更を加える必要もあります。\n\n統合が更新されたら、統合をテストして、新しい API バージョンで動作することを確認します。\n\n"}