Skip to main content

​
Recherche des membres de liste : Standard v1.1 comparé à X API v2

Si vous avez utilisé les points de terminaison standard v1.1 GET lists/members et GET lists/memberships, l’objectif de ce guide est de vous aider à comprendre les similitudes et les différences entre les points de terminaison standard v1.1 et X API v2 pour les membres de Liste.
  • Similitudes
    • Méthodes d’authentification
  • Différences
    • URL des points de terminaison
    • Limites de taux
    • Exigences pour les Apps et les projets
    • 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 à la fois le contexte utilisateur OAuth 1.0a et l’authentification App only. Par conséquent, si vous utilisiez auparavant l’un des endpoints standard v1.1 pour les membres de Liste, vous pouvez continuer à utiliser la même méthode d’authentification lors de votre migration vers la version X API v2. Selon la bibliothèque ou le package d’authentification que vous utilisez, l’authentification App only est probablement le moyen le plus simple de démarrer et se configure au moyen d’un simple en-tête de requête. Pour savoir comment générer un jeton d’accès App only, consultez ce guide App only.

​
Différences

URL des endpoints Limites de taux Exigences relatives aux Apps et aux Projets Les endpoints X API v2 exigent que vous utilisiez des identifiants provenant d’une developer App associée à un Project pour authentifier vos requêtes. Tous les endpoints X API v1.1 peuvent utiliser des identifiants provenant d’Apps ou d’Apps associées à un projet. Limites d’objets de données par requête L’endpoint standard v1.1 /1.1/lists/members vous permet de renvoyer jusqu’à 5000 utilisateurs par requête. Les nouveaux endpoints v2 vous permettent de renvoyer jusqu’à 100 utilisateurs par requête. Par défaut, 100 objets utilisateur 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 passer le next_token renvoyé dans le corps de la réponse au paramètre de requête pagination_token dans votre requête suivante. De plus, l’endpoint /1.1/lists/memberships vous permet de renvoyer jusqu’à 1000 Listes par requête. Avec le remplacement v2, l’endpoint permet jusqu’à 100 Listes par requête. Par défaut, 100 objets Liste sont renvoyés ; utilisez les paramètres de requête max_results= et pagination_token de la même manière que pour /1.1/lists/members pour modifier le nombre de résultats. Format des données de réponse L’une des plus grandes différences entre les versions d’endpoints standard v1.1 et X API v2 est la façon dont vous sélectionnez les champs renvoyés dans votre corps de réponse. Pour les endpoints standard, vous recevez de nombreux champs de réponse par défaut, et vous avez ensuite la possibilité d’utiliser des paramètres pour indiquer quels champs supplémentaires ou ensembles de champs doivent être renvoyés dans le corps de la réponse. La version X API v2 /users/:id/list_memberships renverra par défaut les champs id et name de la Liste. Pour demander des champs ou objets supplémentaires, vous devez utiliser les paramètres fields et expansions. Tout champ de Liste que vous demandez à partir de cet endpoint sera renvoyé dans l’objet Liste principal. Tout objet et champ étendu sera renvoyé dans un objet includes au sein de votre réponse. Vous pouvez ensuite faire correspondre tout objet étendu à l’objet Liste principal en faisant correspondre les id présents à la fois dans l’objet principal et dans l’objet étendu. Voici des exemples de champs de Liste et d’expansions possibles :
  • created_at
  • follower_count
  • member_count
  • owner_id
  • description
  • private
Nous vous encourageons à en savoir plus sur ces nouveaux paramètres dans leurs guides respectifs, ou en lisant notre guide sur comment utiliser les champs et les 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 aussi le paramètre d’extension et le paramètre de champ spécifiques que vous devrez transmettre avec votre requête v2 pour obtenir des champs spécifiques.  En plus des changements concernant la manière de demander certains champs, X API v2 introduit également de nouvelles structures JSON pour les objets renvoyés par les API, notamment les objets Publication et user.
  • Au niveau racine JSON, les endpoints standards renvoient des objets Publication dans un tableau statuses, tandis que X API v2 renvoie un tableau data. 
  • Au lieu de faire référence à des « statuses » Retweeted et Quoted, le JSON de X API v2 fait référence à des 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 Publication) et favourites (dans l’objet user), X API v2 utilise le terme like. 
  • X adopte la convention selon laquelle les valeurs JSON vides (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 : Recherche des membres d’une Liste Recherche d’appartenance à une Liste