À propos des changements cassants dans l’API REST
L’API GitHub REST est versionnée. Le nom de la version de l’API est basé sur la date à laquelle la version de l’API a été publiée. Par exemple, la version 2026-03-10 de l’API a été publiée le Tue, 10 Mar 2026.
Les modifications disruptives sont des changements qui peuvent potentiellement interrompre une intégration. Les changements disruptifs seront publiés dans une nouvelle version d'une API. Nous fournirons un préavis avant de publier des changements cassants. Les modifications disruptives incluent :
- Suppression d’une opération entière
- Suppression ou changement de nom d’un paramètre
- Suppression ou changement de nom d’un champ de réponse
- Ajout d’un nouveau paramètre obligatoire
- Rendre obligatoire un paramètre précédemment facultatif
- Modification du type d’un paramètre ou d’un champ de réponse
- Suppression des valeurs d’énumération
- Ajout d’une nouvelle règle de validation à un paramètre existant
- Modification des exigences d’authentification ou d’autorisation
Tous les changements additifs (non cassants) seront disponibles dans toutes les versions d’API prises en charge. Les changements additifs sont des modifications qui ne doivent pas interrompre une intégration. Les changements additifs sont les suivants :
- Ajout d’une opération
- Ajout d’un paramètre facultatif
- Ajout d’un en-tête de demande facultatif
- Ajout d’un champ de réponse
- Ajout d’un en-tête de réponse
- Ajout de valeurs d’énumération
Lorsqu’une nouvelle version d’API REST est publiée, la version précédente de l’API est prise en charge pendant au moins 24 mois supplémentaires après la publication de la nouvelle version de l’API.
Pour plus d’informations sur les versions de l’API, consultez Versions des API.
Mise à niveau vers une nouvelle version de l’API
Avant de procéder à la mise à niveau vers une nouvelle version d’API REST, vous devez lire la section de cette page qui correspond à la nouvelle version de l’API pour comprendre les changements cassants inclus et pour en savoir plus sur la mise à niveau vers cette version de l’API.
Lorsque vous mettez à jour votre intégration pour spécifier la nouvelle version de l'API dans l'en-tête X-GitHub-Api-Version, vous devez également apporter des modifications requises pour que votre intégration fonctionne avec la nouvelle version de l'API.
Une fois votre intégration mise à jour, testez votre intégration pour vérifier qu’elle fonctionne avec la nouvelle version de l’API.