Skip to main content

​
Recherche de likes : Standard v1.1 et X API v2

Si vous avez travaillé avec l’endpoint Standard v1.1 GET favorites/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 de likes de X API v2. Avec v2, nous avons également introduit un nouvel endpoint des utilisateurs ayant liké, qui vous permet d’obtenir des informations sur les utilisateurs ayant like un Post.
  • Similarités
    • Authentification
    • Limites de taux
  • Différences
    • URL des endpoints
    • Limitations des requêtes
    • Exigences pour l’App et le Project
    • Paramètres de requête
    • Nouveau format JSON

​
Similarités

Authentification Les endpoints de recherche de likes Standard v1.1 et X API v2 utilisent tous deux le Contexte utilisateur OAuth 1.0a ou l’OAuth 2.0 Bearer Token. Par conséquent, si vous utilisiez auparavant les endpoints standard v1.1 GET favorites/list, vous pouvez continuer à utiliser la même méthode d’authentification lors de votre migration vers la version X API v2, si vous le souhaitez.  Selon la bibliothèque ou le package d’authentification que vous utilisez, l’authentification via Jeton Bearer est probablement la façon la plus simple de démarrer et peut être configurée avec un simple en-tête de requête. Pour savoir comment générer un Jeton Bearer, consultez ce guide OAuth 2.0 Bearer Token.    Limites de taux L’endpoint standard v1.1 GET favorites/list a une limite de taux de 75 requêtes par période de 15 minutes et par utilisateur. L’endpoint v2 correspondant pour les Posts likés a la même limite de taux. Cependant, cet endpoint v2 comporte également une limite de taux supplémentaire de 75 requêtes par 15 minutes et par App.

​
Différences

URLs d’endpoint Limitations des requêtes L’endpoint v2 liked Posts vous permet de demander de 5 à 100 Posts par requête, mais vous pouvez récupérer tous les likes d’un Post à l’aide de jetons de pagination. L’endpoint v1.1 GET favorites/list permet également de récupérer tous les likes de Posts, mais vous pouvez récupérer de 20 à 200 Posts par requête. Pour l’endpoint v2 liking users, vous êtes limité à 100 utilisateurs ayant liké par Post.    Exigences App et Project Les endpoints X API v2 exigent que vous utilisiez des identifiants 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 provenant d’Apps autonomes ou d’Apps associées à un Project. 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. L’une des principales différences entre Standard v1.1 et les versions d’endpoint X API v2 est la façon de sélectionner les champs renvoyés dans votre payload. Pour les endpoints Standard, plusieurs paramètres permettaient d’indiquer quels champs ou ensembles de champs devaient être renvoyés dans le payload, tandis que la version X API v2 simplifie ces différents paramètres en fields et expansions.    Nouveau format JSON X API v2 introduit de nouveaux modèles JSON pour les objets renvoyés par les API, y compris les objets Post et user.
  • Au niveau racine du JSON, les endpoints Standard renvoient des objets utilisateur 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 de 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 Post) 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 incluses dans le payload. Les attributs Post et user ne sont inclus que s’ils ont des valeurs non nulles.  
En plus des changements apportés à notre nouveau format JSON, nous avons également introduit un nouvel ensemble de champs dans l’Objet Post, notamment :
⌘I