Skip to main content

​
Recherche des blocages : Standard v1.1 comparée à X API v2

Si vous avez travaillé avec les endpoints Standard v1.1 GET blocks/ids et GET blocks/list, ce guide a pour objectif de vous aider à comprendre les similitudes et les différences entre Standard v1.1 et les endpoints de recherche des blocages de X API v2.
  • Similarités
    • Authentification
  • Différences
    • URL d’endpoint
    • Limites d’utilisateurs par requête
    • Exigences pour l’App et le Project
    • Formats des données de réponse
    • Paramètres de requête

​
Similarités

Authentification Les endpoints de recherche des blocages de Standard v1.1 et de X API v2 utilisent tous deux le Contexte utilisateur OAuth 1.0a. Par conséquent, si vous utilisiez auparavant l’un des endpoints de recherche des blocages Standard v1.1, vous pouvez continuer à utiliser la même méthode d’authentification en migrant vers la version X API v2. 

​
Différences

URLs d’endpoint Limites d’utilisateurs par requête Les endpoints Standard v1.1 permettent de renvoyer jusqu’à 5000 utilisateurs par requête. Les nouveaux endpoints v2 permettent de renvoyer jusqu’à 1000 utilisateurs par requête. Pour obtenir 1000 utilisateurs, vous devez passer max_results=1000 en paramètre query ; vous pouvez ensuite passer le next_token renvoyé dans la charge utile de la réponse au paramètre query pagination_token de votre requête suivante.   Exigences relatives à l’App et au Project Les endpoints X API v2 exigent l’utilisation d’identifiants provenant d’une developer App associée à un Project lors de l’authentification de vos requêtes. Tous les endpoints X API v1.1 peuvent utiliser des identifiants issus d’Apps autonomes ou d’Apps associées à un Project. Format des données de réponse L’une des principales différences entre Standard v1.1 et les versions d’endpoint X API v2 concerne la façon de sélectionner les fields à renvoyer dans la charge utile. Pour les endpoints Standard, de nombreux fields de réponse sont fournis par défaut, et vous pouvez ensuite utiliser des paramètres pour indiquer quels fields ou ensembles de fields doivent être renvoyés dans la charge utile. La version X API v2 ne fournit par défaut que les fields user id, name et username. Pour demander des fields ou objets supplémentaires, vous devrez utiliser les paramètres fields et expansions. Tous les user fields que vous demandez depuis cet endpoint seront renvoyés dans l’objet utilisateur principal. Tout Objet Post étendu et ses fields seront renvoyés dans un objet includes au sein de la réponse. Vous pouvez ensuite faire correspondre les objets étendus à l’objet utilisateur en faisant correspondre les IDs présents à la fois dans l’objet utilisateur et dans l’Objet Post étendu.  Nous vous encourageons à en savoir plus sur ces nouveaux paramètres dans leurs guides respectifs, ou en consultant notre guide sur comment utiliser fields et expansions.  Nous avons également élaboré un guide de migration de format de données qui peut vous aider à faire correspondre les fields Standard v1.1 aux nouveaux fields v2. Ce guide vous fournira aussi les paramètres d’expansion et de field spécifiques à passer avec votre requête v2 pour renvoyer des fields précis.    En plus des changements dans la façon de demander certains fields, X API v2 introduit également de nouvelles conceptions JSON pour les objets renvoyés par les APIs, y compris les objets Post et user.
  • Au niveau racine du JSON, les endpoints Standard renvoient des Objets Post 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 fields 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 Post) et favourites (dans l’objet utilisateur), 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 Post et user ne sont inclus que s’ils ont des valeurs non nulles.   
Nous avons également introduit un nouvel ensemble de fields dans l’Objet Post, notamment :
  • Un field conversation_id
  • Deux nouveaux fields annotations, notamment context et entities
  • Plusieurs nouveaux fields de métriques 
  • Un nouveau field reply_setting, qui indique qui peut répondre à un Post donné
Paramètres de requête Les endpoints Standard v1.1 suivants acceptaient deux paramètres de requête (user_id ou screen_name). La X API v2 n’accepte que l’id utilisateur numérique, qui doit être transmis dans le chemin de l’endpoint.
⌘I