Passer au contenu principal

​
Comment intégrer les endpoints de comptage des Posts

Cette page présente plusieurs outils et concepts clés à connaître pour intégrer à votre système les endpoints de comptage des Posts récents ou de l’archive complète. Nous avons divisé la page en sections :

​
Outils utiles

Avant d’explorer quelques concepts clés, nous vous recommandons d’utiliser l’un des outils ou exemples de code suivants pour commencer à tester la fonctionnalité de ces endpoints.

​
Exemples de code

Vous souhaitez utiliser ces endpoints 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, dont un client Python.

​
Bibliothèques

Profitez de l’une de nos nombreuses bibliothèques tierces de la communauté pour vous aider à démarrer. Vous pouvez trouver une bibliothèque compatible avec les endpoints v2 en recherchant l’étiquette de version appropriée.

​
Postman

Postman est un excellent outil pour tester ces endpoints. Chaque requête Postman inclut tous les paramètres de l’endpoint concerné afin de vous aider à comprendre rapidement ce qui est à votre disposition. Pour en savoir plus sur nos collections Postman, veuillez consulter la page Utiliser Postman.  

​
Concepts fondamentaux

​
Authentification

Tous les endpoints de la X API v2 exigent que les requêtes soient authentifiées à l’aide d’un ensemble d’identifiants, également appelés clés et jetons. Cet endpoint requiert l’utilisation de OAuth 2.0 Bearer Token, ce qui signifie que vous devez transmettre un Jeton Bearer pour que la requête aboutisse. Vous pouvez générer un Jeton Bearer directement dans une App développeur, ou en générer un via l’endpoint POST oauth2/token.

​
developer portal, Projects, et Apps développeur

Pour utiliser n’importe quel endpoint de la X API v2, vous devez disposer d’un compte développeur, configurer un Project dans ce compte, et créer une App développeur au sein de ce Project. Les clés et jetons de cette App développeur fonctionneront avec les endpoints de comptage de Posts récents. Si vous souhaitez utiliser l’endpoint de comptage de Posts de l’archive complète, ou tirer parti des opérateurs avancés et d’une longueur de query plus importante, vous devrez avoir été approuvé pour un accès Enterprise. Veuillez consulter notre section sur l’accès Enterprise pour en savoir plus.

​
Limites de taux

Chaque jour, des dizaines de milliers de développeurs envoient des requêtes à la X API. Pour gérer ce volume, des limites de taux sont appliquées à chaque endpoint, afin de restreindre le nombre de requêtes que chaque développeur peut effectuer pour le compte d’une App ou d’un utilisateur authentifié. Cet endpoint est soumis à une limite de taux au niveau de l’App, ce qui signifie que vous, en tant que développeur, ne pouvez effectuer qu’un certain nombre de requêtes vers cet endpoint sur une période donnée depuis n’importe quelle App (déterminée par les identifiants que vous utilisez). 

​
Créer des queries

La fonctionnalité principale de ces endpoints est l’utilisation d’une seule query pour filtrer les Posts dans les décomptes qui vous sont transmis. Ces queries sont composées d’opérateurs qui ciblent des attributs de Post et d’utilisateur, tels que des mots-clés du message, des hashtags et des URL. Les opérateurs peuvent être combinés au sein de queries à l’aide de logique booléenne et de parenthèses afin d’affiner le comportement d’appariement de la query. Vous pouvez consulter notre guide sur how to build a query pour en savoir plus. Pour les décomptes de Post récents, aucun next_token n’est renvoyé. Quelle que soit la granularité, vous obtiendrez le volume de Post des 7 derniers jours en un seul appel à l’API. Pour les décomptes de Post de l’archive complète, vous obtiendrez des data pour les 30 derniers jours. Pour des data datant de plus de 30 jours, vous recevrez un next_token que vous pourrez ensuite utiliser pour paginer et récupérer les data supplémentaires. 

​
Créer des requêtes pour les décomptes de Posts

Les endpoints des décomptes de Posts acceptent un seul paramètre query avec une requête GET et renvoient un ensemble de décomptes historiques de Posts correspondant à la query. Les requêtes sont composées d’opérateurs utilisés pour faire correspondre une variété d’attributs de Post. 

​
Table des matières

⌘I