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

​
Outils utiles

Avant d’aborder certains 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 que vous pouvez utiliser comme point de départ sur notre page GitHub.

​
Bibliothèques tierces

Profitez de l’une des bibliothèques tierces de 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 X API v2 exigent que vous authentifiiez 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 OAuth 2.0 Autorisation par code avec PKCE pour authentifier vos requêtes vers ces endpoints. Contexte utilisateur OAuth 1.0a vous demande d’utiliser vos API Keys, des Access Tokens utilisateur et plusieurs autres paramètres pour créer un en-tête d’autorisation, que vous joindrez ensuite à votre requête. 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 votre App en utilisant le flux OAuth à 3 étapes. Veuillez noter qu’OAuth 1.0a peut être difficile à utiliser. Si vous n’êtes pas familiarisé avec cette méthode d’authentification, nous vous recommandons d’utiliser une bibliothèque, un outil comme Postman, ou OAuth 2.0 pour authentifier vos requêtes. OAuth 2.0 Autorisation par code avec PKCE permet un meilleur contrôle de la portée d’une application et des flux d’autorisation sur plusieurs appareils. OAuth 2.0 vous permet de choisir des portées fines et spécifiques qui vous confèrent des permissions précises au nom d’un utilisateur. Pour activer OAuth 2.0 dans votre App, vous devez l’activer dans les paramètres d’authentification de votre App, situés dans la section des paramètres du developer portal.

​
Developer portal, Projects, and developer Apps

Pour obtenir un ensemble de justificatifs d’authentification compatibles avec les endpoints de la X API v2, vous devez créer un compte développeur, configurer un Project au sein de ce compte, puis créer une App développeur dans 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 vers la X API. Pour gérer le volume important 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é. Ces endpoints sont soumis à des limites de taux au niveau utilisateur, ce qui signifie que l’utilisateur authentifié pour le compte duquel vous effectuez la requête ne peut appeler l’endpoint qu’un certain nombre de fois, et ce, quel que soit l’App développeur. La limite de taux utilisateur est de 50 requêtes par 15 minutes et par endpoint pour les méthodes POST et DELETE. En revanche, pour la méthode GET, la limite de taux n’est que de 15 requêtes par 15 minutes.  

​
Fields et expansions

Les endpoints GET de la X API v2 permettent 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 :
  • pinned_tweet_id
Le paramètre fields vous permet de sélectionner exactement 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 devrez 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 d’identifiant de conversation. Nous avons ajouté à notre X API v2 data dictionary un guide expliquant comment utiliser fields et expansions conjointement. La recherche des blocages peut renvoyer une grande quantité de data. Pour éviter de renvoyer trop de résultats à un moment donné, nous utilisons la pagination. En savoir plus sur la façon de parcourir les résultats.
⌘I