Guide d’intégration
Vue d'ensemble
Cette page présente les outils et les concepts clés pour intégrer les endpoints de comptage des Publications.
Avant de commencer à explorer certains concepts clés, nous vous recommandons d’utiliser l’un des outils ou exemples de code suivants pour tester le fonctionnement de ces endpoints.
Vous souhaitez mettre en place ces endpoints avec un peu de 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, y compris un client Python.
Tirez parti de l’une de nos nombreuses bibliothèques tierces développées par la communauté pour vous aider à démarrer. Vous pouvez trouver une bibliothèque compatible avec les endpoints v2 en recherchant le tag de version approprié.
Postman est un excellent outil que vous pouvez utiliser pour tester ces endpoints. Chaque requête Postman inclut l’ensemble des paramètres de l’endpoint concerné pour vous aider à comprendre rapidement ce qui est à votre disposition. Pour en savoir plus sur nos collections Postman, veuillez consulter notre page Utiliser Postman.
Tous les endpoints de X API v2 exigent que les requêtes soient authentifiées avec un ensemble d’identifiants, également appelés clés et jetons. Cet endpoint nécessite l’utilisation d’un Jeton Bearer OAuth 2.0, ce qui signifie que vous devez transmettre un Jeton Bearer pour réussir votre requête. Vous pouvez générer un Jeton Bearer directement au sein d’une App développeur ou en générer un à l’aide de l’endpoint POST oauth2/token.
Pour utiliser n’importe quel endpoint de X API v2, vous devez disposer d’un compte développeur, configurer un Project dans ce compte, puis créer une App développeur dans ce Project. Les clés et jetons générés dans cette App développeur seront valides pour les endpoints de comptage de Publications récentes. Si vous souhaitez utiliser l’endpoint de comptage de Publications sur l’archive complète, ou exploiter les opérateurs avancés et une longueur de requête plus élevée, vous devrez avoir obtenu une approbation pour l’accès Enterprise.
Pour en savoir plus, consultez la section consacrée à l’accès Enterprise.
Chaque jour, plusieurs milliers de développeurs effectuent des requêtes auprès du X API. Pour aider à gérer ce volume, des limites de taux sont appliquées à chaque endpoint, ce qui limite le nombre de requêtes que chaque développeur peut effectuer au nom d’une App ou au nom d’un utilisateur authentifié.
Cet endpoint est soumis à des limites 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 une App donnée (déterminée par les identifiants que vous utilisez).
La fonctionnalité principale de ces endpoints est l’utilisation d’une seule requête pour filtrer les Publications en décomptes que vous recevez. Ces requêtes sont constituées d’opérateurs qui ciblent des attributs de Publication et d’utilisateur, tels que des mots-clés de message, des hashtags et des URL. Les opérateurs peuvent être combinés au sein de requêtes à l’aide de logique booléenne et de parenthèses pour affiner le comportement de correspondance de la requête.
Vous pouvez utiliser notre guide sur comment créer une requête pour en savoir plus.
Pour les décomptes récents de Publications, aucun next_token n’est renvoyé, ce qui signifie que, quelle que soit la granularité, vous obtiendrez le volume de Publications des 7 derniers jours en un seul appel d’API.
Pour les décomptes de Publications sur l’archive complète, vous obtiendrez des données pour les 30 derniers jours. Pour des données de plus de 30 jours, vous recevrez un next_token que vous pourrez ensuite utiliser pour effectuer la pagination et récupérer les données supplémentaires.