Passer au contenu principal
Cette page présente plusieurs outils et concepts clés à connaître lors de l’intégration des endpoint de Retweet dans votre système. Nous avons organisé la page en plusieurs sections :

​
Outils utiles

Avant d’aborder quelques concepts clés qui vous aideront à intégrer cet endpoint, nous vous recommandons de vous familiariser avec :

​
Postman

Postman est un excellent outil pour tester un endpoint. Chaque requête Postman inclut tous les paramètres de chemin et de corps afin de vous aider à comprendre rapidement ce qui est disponible. Pour en savoir plus sur nos collections Postman, consultez notre page “Using Postman”. 

​
Exemples de code

Vous souhaitez utiliser cet endpoint avec du code dans votre langage de programmation préféré ? Nous proposons plusieurs exemples de code à utiliser comme point de départ sur notre page GitHub.

​
Bibliothèques tierces

Tirez parti des bibliothèques tierces proposées par nos communautés pour vous aider à démarrer. Vous pouvez trouver une bibliothèque compatible avec les endpoints v2 en recherchant l’étiquette de version appropriée.  

​
Concepts clés

​
Authentification

Tous les endpoints de la X API v2 exigent d’authentifier vos requêtes à l’aide d’un ensemble d’identifiants, également appelés clés et jetons. Vous pouvez utiliser soit le Contexte utilisateur OAuth 1.0a, soit l’OAuth 2.0 Bearer Token pour authentifier vos requêtes vers l’endpoint de consultation des Retweets. Les endpoints de gestion des Retweets nécessitent l’utilisation du Contexte utilisateur OAuth 1.0a, ce qui signifie que vous devez utiliser un ensemble de clés d’API et de jetons d’accès utilisateur pour effectuer une requête avec succès. Les access tokens doivent être associés à l’utilisateur pour le compte duquel vous effectuez la requête. Si vous souhaitez générer un ensemble d’access tokens pour un autre utilisateur, celui-ci doit autoriser ou authentifier votre App via le flux OAuth à 3 étapes. Veuillez noter qu’OAuth 1.0a peut être difficile à utiliser. Si vous ne connaissez pas cette méthode d’authentification, nous vous recommandons d’utiliser une bibliothèque pour authentifier correctement vos requêtes. Veuillez noter Si vous demandez les fields suivants, le Contexte utilisateur OAuth 1.0a est requis :
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

​
developer portal, Projects et Apps développeur

Pour obtenir un ensemble d’identifiants d’authentification compatibles avec les endpoints de la X API v2, vous devez créer un compte développeur, configurer un Project dans ce compte, puis créer une App développeur au sein de ce Project. Vous pourrez ensuite retrouver vos clés et jetons dans votre App développeur.   

​
Limites de taux

Chaque jour, plusieurs milliers de développeurs envoient des requêtes à la X API. Pour gérer l’important volume de ces requêtes, des limites de taux sont appliquées à chaque endpoint, ce qui restreint le nombre de requêtes que vous pouvez effectuer pour le compte de votre App ou d’un utilisateur authentifié. Les endpoints de gestion des Retweets sont limités à 50 requêtes par 15 min (par utilisateur). De plus, pour l’endpoint POST, vous êtes limité à 300 requêtes par fenêtre de 3 heures (par utilisateur, par App). Avec l’endpoint de recherche des Retweets, vous êtes limité à 75 requêtes par fenêtre de 15 min. En outre, seuls les 100 utilisateurs ayant effectué le plus récemment un Retweet seront renvoyés par cet endpoint.

​
fields et expansions

La X API v2 permet aux utilisateurs de sélectionner précisément quelles data ils souhaitent obtenir depuis l’API à l’aide d’un ensemble d’outils appelés fields et expansions. Le paramètre expansions vous permet d’inclure les objets référencés dans le payload. Par exemple, cet endpoint vous permet de récupérer les expansions suivantes :
  • attachments.poll_ids
  • attachments.media_keys
  • author_id, entities.mentions.username
  • geo.place_id
  • in_reply_to_user_id,
  • referenced_tweets.id,
  • referenced_tweets.id.author_id
Le paramètre fields vous permet de sélectionner précisément quels fields au sein des différents objets de data vous souhaitez recevoir. Ces endpoints renvoient principalement des Objet Post. Par défaut, l’Objet Post renvoie les champs id et text. Pour recevoir des champs supplémentaires tels que tweet.created_at ou tweet.entities, vous devez les demander explicitement en utilisant un paramètre fields. Parmi les champs importants à envisager pour votre intégration figurent nos données de sondage, les métriques, les Post annotations et les champs conversation_id. Nous avons ajouté à notre X API v2 data dictionary un guide expliquant comment utiliser fields et expansions conjointement.
⌘I