Skip to main content
La dernière version de la X API v2 est une avancée majeure. Pour cette raison, nous avons divisé cette section de migration en plusieurs parties :

​
Qu’est-ce que X API v2 ?

X API v2 est désormais l’API X principale, et c’est là que se concentrent les investissements produits et l’innovation. Nous avons collaboré avec des développeurs pour créer la nouvelle génération de X API afin de mieux servir notre communauté de développeurs, large et diversifiée. À partir des retours des développeurs, nous avons repensé l’API pour mieux répondre à un éventail plus large de besoins, introduit de nouvelles fonctionnalités et de nouveaux endpoints, et amélioré l’expérience des développeurs. X API v2 est désormais l’API X principale, et c’est là que se concentrent les investissements produits et l’innovation. Au cours des dernières années, nous avons collaboré avec des développeurs et repensé l’API pour mieux répondre à un éventail plus large de besoins, introduire de nouvelles fonctionnalités et de nouveaux endpoints, et améliorer l’expérience des développeurs. Nous nous engageons à continuer de bâtir une plateforme ouverte pour les développeurs, et nous sommes impatients de découvrir ce que vous allez créer avec X API v2.

​
Pourquoi migrer ?

La X API v2 est construite sur des bases modernes et plus durables, et inclut à la fois des endpoints de remplacement améliorés pour la version standard v1.1 et les produits Enterprise, ainsi que des fonctionnalités entièrement inédites. Nous encourageons fortement les clients des API héritées (v1.1 et Enterprise) à commencer à migrer vers v2, car nous avons l’intention de les mettre hors service à terme. Utilisez la X API pour écouter et analyser la conversation publique, interagir avec les personnes sur X et innover. Dans cette section, nous aborderons les endpoints et leurs fonctionnalités.

​
Points de terminaison v2

Vous pouvez consulter une liste complète des points de terminaison v2 et de leurs équivalents pré‑v2 dans le guide ci‑dessous : Bien que la plupart des points de terminaison de X API v2 remplacent des points de terminaison existants, nous avons introduit plusieurs nouveaux points de terminaison. Voici quelques exemples de nouveaux points de terminaison que nous avons mis à disposition dans la v2 :

​
Nouvelles fonctionnalités

X API v2 comprend également de nouvelles fonctionnalités qui vous aideront à tirer davantage parti de X API. Une grande partie de ces nouveautés est issue de vos retours et inclut certaines fonctionnalités auparavant réservées aux clients entreprises. Voici quelques-unes des améliorations apportées à l’API :

​
Découvrir les nouveaux objets de réponse et ceux mis à jour

Les six objets de données suivants sont disponibles avec les endpoints v2 : Découvrez plus en détail comment utiliser les champs et les expansions.

​
Flexibilité pour choisir les objets et les champs que vous recevez

Lorsque vous effectuez une requête GET sur un endpoint, vous recevez l’objet de données principal lié à cet endpoint, qui inclut un ensemble de champs par défaut. Par exemple, l’objet Tweet renvoie par défaut les champs id et text. Si vous souhaitez récupérer des champs supplémentaires avec votre requête, vous devrez utiliser les paramètres fields et expansions. Le paramètre expansions vous permet de récupérer des objets de données associés, comme le Tweet épinglé d’un utilisateur ou un objet média, tandis que les opérateurs de champs vous permettent de demander des champs spécifiques au sein des objets renvoyés, au-delà des champs par défaut. Voici la liste complète des expansions que vous pouvez demander avec les différents endpoints de X API v2 : Pour en savoir plus, consultez comment utiliser les champs et les expansions.

​
Nouvelles métriques disponibles dans les Tweets, utilisateurs, Spaces et objets média

Davantage de métriques sont désormais accessibles pour les objets Tweet, utilisateur, Spaces, Listes et média. Ces métriques peuvent être publiques ou privées, et certaines peuvent être ventilées par contexte organique ou sponsorisé pour les publicités de Tweets. En savoir plus sur les métriques disponibles.

​
Modifier des Tweets

Les endpoints de la X API v2 fournissent des métadonnées sur les Tweets modifiés. La fonctionnalité Modifier le Tweet a été introduite pour des tests auprès des employés de X le 1er septembre 2022. À compter de cette date, les Tweets remplissant les conditions peuvent être modifiés pendant 30 minutes et jusqu’à 5 fois. En savoir plus sur Modifier les Tweets. En utilisant la X API v2, un développeur peut déterminer :
  • Si un Tweet était éligible à la modification au moment de sa création. Certains Tweets, comme ceux contenant des sondages ou les Tweets programmés, ne peuvent pas être modifiés.
  • Les Tweets sont modifiables pendant 30 minutes et peuvent être modifiés jusqu’à 5 fois. Pour les Tweets modifiables, vous pouvez savoir s’il reste du temps pour les modifier et combien de modifications supplémentaires sont possibles.
  • Si vous consultez une version modifiée d’un Tweet (dans la plupart des cas, l’API renverra la version la plus récente d’un Tweet, sauf si une version antérieure spécifique est demandée par Tweet ID).
  • L’intégralité de l’historique de modification du Tweet.
  • L’engagement attribué à chaque version du Tweet.

​
Suivez les conversations sous forme de fils

Un nouveau champ de Tweet permet d’identifier le fil de conversation auquel un Tweet appartient. Un ID de conversation est l’ID du Tweet qui a démarré la conversation. En savoir plus sur le suivi des conversations.

​
Prêt à migrer

Pour utiliser les endpoints v2, vous aurez besoin des éléments suivants : Veuillez noter qu’il est essentiel d’utiliser des clés et des tokens issus d’une App au sein d’un Project. Si vous utilisez des clés et des tokens provenant d’une App en dehors d’un Project, vous ne pourrez pas effectuer de requêtes vers les endpoints v2. Une fois que vous avez un compte développeur, vous pouvez configurer tous les éléments ci-dessus dans la Console de développement.

​
Authentification

Avec la nouvelle API Twitter, vous utiliserez deux mécanismes d’authentification différents, OAuth 1.0a User Context et OAuth 2.0 Jeton Bearer, pour accéder à différents endpoints. Chacun remplit une fonction différente lors de l’envoi de requêtes aux endpoints : OAuth 1.0a User Context est requis lorsque vous envoyez une requête pour le compte d’un utilisateur Twitter
OAuth 2.0 Jeton Bearer est requis pour envoyer des requêtes pour le compte de votre App de développeur

​
Outils et code

Pour vous aider à démarrer et à vous familiariser avec les nouveaux endpoints et fonctionnalités, nous proposons plusieurs options pour lancer votre travail :
  • Nous mettons à disposition une collection Postman Twitter qui vous permet d’utiliser le client Postman pour envoyer des requêtes et vous connecter à chacun des endpoints. C’est une méthode simple pour tester l’authentification et expérimenter avec les endpoints.
  • Nous mettons également à disposition une liste de bibliothèques, prises en charge par Twitter ou tierces, en Ruby, Python, Node, Java et bien d’autres. Pour plus de contexte, consultez notre page sur les outils et bibliothèques.

​
Migration vers les endpoints mis à jour

À mesure que vous commencez à explorer les nouveaux endpoints Twitter v2, nous avons créé une série de guides de migration détaillés pour vous aider à comparer les fonctionnalités de chaque endpoint mis à jour avec celles des anciennes versions :

​
Migration vers le nouveau format de données

Lorsque vous passez de v1.1 ou d’Enterprise à v2, il est important de comprendre que le format dans lequel les données sont livrées a considérablement changé. Nous avons ajouté de nouveaux champs, modifié l’ordre des champs et, dans certains cas, supprimé certains éléments. Pour en savoir plus sur ces changements, nous préparons une série de guides qui vous aideront à faire correspondre les champs du format de données pré‑v2 aux nouveaux champs, et à savoir comment demander ces nouveaux champs. Vous pouvez en apprendre davantage en consultant la section migration des formats de données de ce hub de migration, ou en visitant nos guides spécifiques sur les formats de données :

​
Et la suite ?

Ceux d’entre vous qui utilisent la plateforme depuis un certain temps remarqueront que de nombreux nouveaux endpoints sont alignés sur les endpoints standard v1.1 et enterprise existants. En effet, nous avons bien l’intention qu’ils remplacent à terme ces trois versions. Nous avons préparé un tableau pour vous aider à comprendre comment les endpoints X API correspondent aux versions précédentes. Si vous souhaitez voir ce qui est prévu pour la suite, veuillez consulter notre feuille de route produit. Nous avons également un changelog que vous pouvez consulter pour voir ce que nous avons déjà publié.

​
Que devrions-nous développer ensuite ?

À mesure que nous étendons les capacités de la X API v2, nous souhaitons continuer à recueillir vos retours. Nous accueillons volontiers vos retours et vous encourageons à nous en faire part. Parcourez les idées déjà soumises, soutenez celles qui correspondent à vos besoins et partagez également vos propres retours !