Passer au contenu principal
Ces trois endpoints de chronologie prennent en charge les Posts modifiés. Ces endpoints renverront toujours la version la plus récente, ainsi que l’historique des modifications. Tout Post collecté après sa fenêtre de modification de 30 minutes correspondra à sa version finale. Les métadonnées de modification incluent un tableau d’ID pour tous les Posts de son historique. Pour les Posts sans historique de modification, ce tableau contiendra un seul ID. Pour les Posts qui ont été modifiés, ce tableau contient plusieurs ID, classés par ordre croissant reflétant la séquence des modifications, avec la version la plus récente en dernière position du tableau. Pour en savoir plus sur le fonctionnement des modifications de Post, consultez la page Principes fondamentaux des modifications de Post.

​
Fil d’accueil en ordre antichronologique

Cet endpoint permet de récupérer les Posts, Retweets et réponses les plus récents publiés par l’utilisateur authentifié et les comptes qu’il suit. Comme vous effectuez des requêtes pour le compte d’un utilisateur, vous devez authentifier ces endpoints à l’aide d’un OAuth 2.0 Authorization Code Flow with PKCE ou du Contexte utilisateur OAuth 1.0a. Cet endpoint est soumis à une limite de taux par utilisateur de 180 requêtes par fenêtre de 15 minutes. Il peut renvoyer tous les Posts créés sur une timeline au cours des 7 derniers jours, ainsi que les 800 plus récents, quelle que soit leur date de création.

​
Chronologie des Posts d’utilisateur

L’endpoint de chronologie des Posts d’utilisateur donne accès aux Posts publiés par un compte X spécifique. Récupérer les Posts d’un utilisateur vous permet de créer des expériences telles que l’affichage d’une chronologie dans une interface utilisateur, l’analyse des Posts d’un utilisateur pour mieux comprendre son contenu ou la création de workflows d’engagement avec ses Posts de manière programmatique. Cet endpoint donne accès aux Posts, Retweets, réponses et Quote Tweets les plus récents d’un compte X, similaire à ce qui peut être vu sur la chronologie du profil d’un utilisateur. Voici une chronologie d’utilisateur pour @XDevelopers : L’endpoint de chronologie des Posts d’utilisateur est un endpoint REST qui reçoit un unique paramètre de chemin pour indiquer l’utilisateur souhaité (par id utilisateur). L’endpoint peut renvoyer jusqu’à 3 200 Posts, Retweets, réponses et Quote Tweets parmi les plus récents publiés par l’utilisateur. Les Posts sont renvoyés par ordre antéchronologique, en commençant par le plus récent. Les résultats sont paginés jusqu’à 100 Posts par page. Des jetons de pagination sont fournis pour parcourir de grands ensembles de Posts. Les ID de Post des Posts le plus récent et le plus ancien inclus dans la page donnée sont également fournis en tant que metadata, qui peuvent aussi être utilisés pour interroger les chronologies afin d’identifier des Posts récents. La chronologie des Posts d’utilisateur prend également en charge la possibilité de spécifier les paramètres start_time et end_time pour recevoir des Posts créés dans une fenêtre temporelle donnée. L’endpoint de chronologie des Posts d’utilisateur prend en charge les paramètres fields et expansions, et renvoie le nouveau format de données JSON. Pour effectuer une requête avec succès vers cet endpoint, vous devrez autoriser votre requête avec les méthodes d’authentification Contexte utilisateur OAuth 1.0a, OAuth 2.0 Autorisation par code avec PKCE ou OAuth 2.0 App-Only. Vous devez utiliser Contexte utilisateur OAuth 1.0a ou OAuth 2.0 Autorisation par code avec PKCE lorsque vous demandez des métriques non publiques, des métriques promues ou la chronologie d’un utilisateur protégé. L’endpoint de chronologie des Posts d’utilisateur est conçu pour prendre en charge deux modèles d’utilisation courants :
  • « Obtenir l’historique des Posts d’un utilisateur » : Requêtes effectuées vers la chronologie des Posts d’utilisateur afin de recevoir les Posts rédigés par l’utilisateur concerné dans l’ordre chronologique sur une période récente spécifique. La période peut être définie à l’aide de start_time et end_time et en paginant l’ensemble des résultats. Dans certains cas, l’historique complet des Posts d’un utilisateur peut être récupéré si l’utilisateur n’a rédigé qu’au plus 3 200 Posts sur son compte. Les Posts inclus dépendront de la disponibilité publique et de l’authentification utilisée pour les requêtes.
  • « Sondage pour de nouveaux Posts » : Requêtes effectuées vers la chronologie des Posts d’utilisateur de manière continue afin de récupérer les nouveaux Posts rédigés par un utilisateur spécifique. Le dernier ID de Post reçu peut être fourni en paramètre pour toute nouvelle requête depuis le dernier Post.

​
Chronologie des mentions d’utilisateur

L’endpoint de chronologie des mentions d’utilisateur vous permet de demander des Posts mentionnant un utilisateur X spécifique. Par exemple, si un compte X a mentionné @XDevelopers dans un Post. Cela inclut également les réponses aux Posts de l’utilisateur ciblé. Récupérer les mentions d’un utilisateur vous permet de créer des expériences telles que découvrir rapidement qui répond aux Posts d’un utilisateur, qui le mentionne, ou mettre en place des workflows d’engagement avec ses Posts de manière programmatique. L’endpoint permet de demander les mentions et réponses les plus récentes d’un seul utilisateur, de manière similaire à ce que l’on peut voir dans les notifications pour les mentions d’un utilisateur sur X. La chronologie des mentions d’utilisateur est un endpoint REST qui reçoit un unique paramètre de chemin pour indiquer l’utilisateur souhaité (par id d’utilisateur). L’endpoint peut renvoyer jusqu’aux 800 mentions les plus récentes pour cet utilisateur. Les Posts sont renvoyés dans l’ordre antéchronologique, en commençant par le plus récent. Les résultats sont paginés jusqu’à 100 Posts par page. Des jetons de pagination sont fournis pour parcourir de grands ensembles de Posts. Les ID de Post des Posts le plus récent et le plus ancien inclus dans la page donnée sont également fournis en tant que metadata, lesquels peuvent servir à sonder les chronologies pour des Posts récents ou à naviguer dans la chronologie, de manière similaire à l’endpoint v1.1 mentions_timeline. L’endpoint prend également en charge la possibilité de spécifier les paramètres start_time et end_time pour recevoir des Posts créés dans une fenêtre temporelle donnée.  Pour effectuer une requête vers cet endpoint, vous devrez autoriser votre requête avec les méthodes d’authentification Contexte utilisateur OAuth 1.0a, OAuth 2.0 Autorisation par code avec PKCE ou OAuth 2.0 App-Only. Vous devez utiliser Contexte utilisateur OAuth 1.0a ou OAuth 2.0 Autorisation par code avec PKCE lorsque vous demandez des métriques non publiques, des métriques promues ou la chronologie d’un utilisateur protégé. L’endpoint de chronologie des mentions d’utilisateur prend en charge les paramètres fields et expansions, et renvoie le nouveau format de données JSON.
Configuration du comptePour accéder à ces endpoints, vous aurez besoin de :En savoir plus sur l’accès aux endpoints X API v2 dans notre guide de démarrage.
Ressources d’assistance Apprenez à utiliser Postman pour effectuer des requêtes Résoudre une erreur Visitez la page de référence de l’API pour cet endpoint
⌘I