> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

***

<div id="current-versions">
  ## Versions actuelles
</div>

| 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                                      |

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

***

<div id="version-in-urls">
  ## Version dans les URL
</div>

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

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

***

<div id="breaking-vs-non-breaking-changes">
  ## Modifications non rétrocompatibles et rétrocompatibles
</div>

<div id="breaking-changes-require-code-updates">
  ### Modifications non rétrocompatibles (nécessitent des mises à jour du code)
</div>

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

<div id="non-breaking-changes-additive">
  ### Modifications rétrocompatibles (additives)
</div>

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é

***

<div id="release-schedule">
  ## Calendrier des versions
</div>

| 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 |

***

<div id="deprecation-policy">
  ## Politique d’obsolescence
</div>

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

<div id="definitions">
  ### Définitions
</div>

| 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                                                                                |

***

<div id="staying-informed">
  ## Rester informé
</div>

Recevez une notification en cas de changement :

<CardGroup cols={2}>
  <Card title="Journal des modifications" icon="clock-rotate-left" href="/fr/changelog">
    Toutes les modifications et mises à jour de la plateforme.
  </Card>

  <Card title="Annonces du forum" icon="bullhorn" href="https://devcommunity.x.com/c/announcements/22">
    Annonces de changements majeurs incompatibles.
  </Card>

  <Card title="@XDevelopers" icon="x-twitter" href="https://x.com/XDevelopers">
    Actualités et mises à jour de la plateforme.
  </Card>

  <Card title="Newsletter" icon="envelope" href="/fr/newsletter">
    Résumé mensuel.
  </Card>
</CardGroup>

***

<div id="migration-resources">
  ## Ressources de migration
</div>

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

<CardGroup cols={2}>
  <Card title="Présentation de la migration" icon="route" href="/fr/x-api/migrate/overview">
    Recommandations de migration en vigueur.
  </Card>

  <Card title="Correspondance des endpoints" icon="map" href="/fr/x-api/migrate/x-api-endpoint-map">
    Correspondance des endpoints entre v1 et v2.
  </Card>
</CardGroup>

***

<div id="best-practices">
  ## Bonnes pratiques
</div>

<CardGroup cols={2}>
  <Card title="Utilisez v2" icon="arrow-up">
    Démarrez les nouveaux projets sur la version la plus récente.
  </Card>

  <Card title="Suivez les annonces" icon="bell">
    Abonnez-vous au journal des modifications et aux mises à jour du forum.
  </Card>

  <Card title="Testez les changements" icon="flask">
    Testez en environnement de développement avant les mises à jour en production.
  </Card>

  <Card title="Planifiez les migrations" icon="calendar">
    N'attendez pas l'obsolescence pour mettre à niveau.
  </Card>
</CardGroup>