Skip to main content

​
Consultation des publications d’une Liste : standard v1.1 comparé à X API v2

Si vous utilisez le endpoint standard v1.1 GET lists/statuses, l’objectif de ce guide est de vous aider à comprendre les similitudes et les différences entre les endpoints standard v1.1 et X API v2.
  • Similitudes
    • Méthodes d’authentification
    • Limites de taux
  • Différences
    • URLs des endpoints
    • Exigences relatives à l’App et au projet
    • Nombre maximal d’objets de données par requête
    • Formats des données de réponse
    • Paramètres de requête

​
Similarités

Authentification Les deux versions de l’endpoint prennent en charge OAuth 1.0a User Context. Par conséquent, si vous utilisiez auparavant l’un des endpoints standard v1.1 de recherche de Publications dans une Liste, vous pouvez continuer à utiliser la même méthode d’authentification si vous migrez vers la version X API v2. Selon la bibliothèque/package d’authentification de votre choix, l’authentification App only est probablement la façon la plus simple de commencer et peut être configurée avec un simple en-tête de requête. Pour savoir comment générer un Access Token App only, consultez ce guide App only. Limites de taux
Standard v1.1X API v2
/1.1/lists/statuses.json

900 requêtes par fenêtre de 15 minutes avec OAuth 1.0a User Context

900 requêtes par fenêtre de 15 minutes avec App only		/2/lists/:id/tweets

900 requêtes par fenêtre de 15 minutes avec OAuth 1.0a User Context

900 requêtes par fenêtre de 15 minutes avec OAuth 2.0 Authorization Code with PKCE

900 requêtes par fenêtre de 15 minutes avec App only

​
Différences

URLs d’endpoint Exigences pour les App et les Projets Les endpoints X API v2 exigent que vous utilisiez des informations d’identification issues d’une App développeur associée à un Project lors de l’authentification de vos requêtes. Tous les endpoints X API v1.1 peuvent utiliser des informations d’identification provenant d’App ou d’App associées à un projet. Limites d’objets de données par requête L’endpoint standard v1.1 /lists/statuses vous permet de récupérer jusqu’à 5000 Publications par requête. Les nouveaux endpoints v2 vous permettent de récupérer jusqu’à 100 Publications par requête. Par défaut, 100 objets user sont renvoyés. Pour modifier le nombre de résultats, vous devez passer un paramètre de requête max_results= avec une valeur comprise entre 1 et 100 ; vous pouvez ensuite transmettre le next_token renvoyé dans le corps de la réponse au paramètre de requête pagination_token dans votre requête suivante. Format des données de réponse L’une des plus grandes différences entre les versions d’endpoint standard v1.1 et X API v2 est la manière dont vous sélectionnez les champs renvoyés dans votre charge utile. Pour les endpoints standard, vous recevez de nombreux champs de réponse par défaut, avec ensuite la possibilité d’utiliser des paramètres pour identifier les champs supplémentaires ou les ensembles de champs qui doivent être renvoyés dans la charge utile. La version X API v2 ne fournit par défaut que les champs id et text de la Publication. Pour demander des champs ou des objets supplémentaires, vous devrez utiliser les paramètres fields et expansions. Tous les champs de Publication que vous demandez à partir de cet endpoint seront renvoyés dans l’objet principal de Publication. Tous les champs d’objets étendus seront renvoyés dans un objet includes au sein de votre réponse. Vous pouvez ensuite faire correspondre tout objet étendu à l’objet principal de Publication en faisant correspondre les ID de l’objet principal et des objets étendus. Voici des exemples de champs de Publication et d’expansions possibles :
  • attachments
  • author_id
  • context_annotations
  • created_at
  • geo
  • lang
EndpointExpansion
/2/lists/:id/tweetsauthor_id
Nous vous encourageons à en apprendre davantage sur ces nouveaux paramètres dans leurs guides respectifs, ou en lisant notre guide sur comment utiliser les fields et expansions. Nous avons également élaboré un guide de migration de format de données qui peut vous aider à faire correspondre les champs standard v1.1 aux nouveaux champs v2. Ce guide vous fournira également le paramètre d’expansion et de field spécifique que vous devrez transmettre avec votre requête v2 pour renvoyer des champs spécifiques. En plus des changements relatifs à la manière de demander certains champs, X API v2 introduit également de nouveaux modèles JSON pour les objets renvoyés par les API, y compris les objets Post et user.
  • Au niveau racine JSON, les endpoints standard renvoient les objets de Publication dans un tableau statuses, tandis que X API v2 renvoie un tableau data.
  • Au lieu de faire référence aux « statuses » Retweeted et Quoted, le JSON X API v2 fait référence aux Tweets Retweeted et Quoted. De nombreux champs hérités et obsolètes, tels que contributors et user.translator_type, sont supprimés.
  • Au lieu d’utiliser à la fois favorites (dans l’objet de Publication) et favourites (dans l’objet user), X API v2 utilise le terme like.
  • X adopte la convention selon laquelle les valeurs JSON sans valeur (par exemple, null) ne sont pas écrites dans la charge utile. Les attributs de Publication et de user ne sont inclus que s’ils ont des valeurs non nulles.
Paramètres de requête Les paramètres de requête standard v1.1 suivants ont des équivalents dans X API v2 :
Standard v1.1X API v2
list_idid
slugAucun équivalent
owner_screen_nameAucun équivalent
owner_idDemandé avec le paramètre expansions avec la valeur author_id
since_idAucun équivalent
max_idAucun équivalent
include_entitiesDemandé avec le paramètre tweet.fields avec la valeur entities
include_rtsAucun équivalent
countmax_results

​
Exemples de code

​
Récupérer des Publications d’une Liste (v2)

cURL
curl "https://api.x.com/2/lists/84839422/tweets?tweet.fields=created_at,public_metrics&max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"