Gestion des versions

Stratégie de gestion des versions de X API et politique de dépréciation

X API utilise des numéros de version dans les chemins d’URL de ses endpoints afin de garantir la stabilité tout en permettant l’évolution. Comprendre notre stratégie de gestion des versions vous aide à planifier vos intégrations et à rester à jour.

---

​

Versions actuelles

Version	Statut	Description
v2	Active	Endpoints modernes, tarification flexible, toutes les nouvelles fonctionnalités
v1.1	Ancienne	Prise en charge limitée, mises à jour minimales
Enterprise	Disponible	Accès à fort volume avec assistance dédiée

Utilisez X API v2 pour tous les nouveaux projets. C’est là que toutes les nouvelles fonctionnalités sont déployées.

---

​

Version dans les URL

Le numéro de version figure dans le chemin de l’endpoint :

https://api.x.com/2/tweets
                   ^
                   version

---

​

Modifications non rétrocompatibles et rétrocompatibles

​

Modifications non rétrocompatibles (nécessitent des mises à jour du code)

Ces modifications ne se produisent que lors des montées de version majeures :

• Suppression d’un endpoint
• Suppression d’un champ de réponse
• Suppression d’un paramètre de requête
• Ajout d’un nouveau paramètre obligatoire
• Modification du type de données d’un champ
• Changement de nom d’un champ ou d’une ressource
• Modification des codes de réponse ou des types d’erreur
• Modification des scopes d’autorisation

​

Modifications rétrocompatibles (additives)

Ces modifications peuvent intervenir à tout moment sans changement de version :

• Ajout d’un nouvel endpoint
• Ajout d’un nouveau paramètre facultatif
• Ajout d’un nouveau champ de réponse
• Ajout de nouveaux périmètres OAuth
• Modification du texte des messages d’erreur
• Mise à la valeur null de champs pour des raisons de confidentialité/sécurité

---

​

Calendrier des versions

Type	Fréquence	Préavis
Versions majeures	Pas plus d’une fois par an	Guides de migration fournis
Modifications rétrocompatibles	En continu	Mises à jour du journal des modifications
Correctifs de sécurité	Selon les besoins	Peuvent être appliqués à la version actuelle

---

​

Politique d’obsolescence

Lorsque nous publions une nouvelle version majeure :

1. Mise en obsolescence : la version précédente est déclarée obsolète
2. Période de support : la version obsolète continue de fonctionner pendant une période déterminée
3. Retrait : la version obsolète est retirée

​

Définitions

Statut	Signification
Actif	Entièrement pris en charge, avec de nouvelles fonctionnalités et des correctifs
Obsolète	Aucune nouvelle fonctionnalité ; seuls les bogues critiques sont corrigés ; utilisation déconseillée
Retiré	N’est plus accessible

---

​

Rester informé

Recevez une notification en cas de changement :

Journal des modifications

Toutes les modifications et mises à jour de la plateforme.

Annonces du forum

Annonces de changements majeurs incompatibles.

@XDevelopers

Actualités et mises à jour de la plateforme.

Newsletter

Résumé mensuel.

---

​

Ressources de migration

Lorsqu’une nouvelle version est publiée, nous fournissons :

• Guides de migration : instructions de mise à niveau étape par étape
• Correspondance des endpoints : équivalents entre v1 et v2
• Modifications du format de données : différences de modèle d’objets

Présentation de la migration

Recommandations de migration en vigueur.

Correspondance des endpoints

Correspondance des endpoints entre v1 et v2.

---

​

Bonnes pratiques

Utilisez v2

Démarrez les nouveaux projets sur la version la plus récente.

Suivez les annonces

Abonnez-vous au journal des modifications et aux mises à jour du forum.

Testez les changements

Testez en environnement de développement avant les mises à jour en production.

Planifiez les migrations

N’attendez pas l’obsolescence pour mettre à niveau.