Skip to main content

​
Recherche de mentions J’aime : version standard v1.1 par rapport à X API v2

Si vous avez utilisé l’endpoint standard v1.1 GET favorites/list, l’objectif de ce guide est de vous aider à comprendre les similitudes et les différences entre les endpoints de recherche de mentions J’aime de la version standard v1.1 et de X API v2. Avec v2, nous avons également introduit un nouvel endpoint liked users qui vous permet d’obtenir des informations sur les utilisateurs qui aiment une Publication.
  • Similitudes
    • Authentification
    • Limites de taux
  • Différences
    • URL des endpoints
    • Limitations des requêtes
    • Exigences liées à l’App et au Project
    • Paramètres de requête
    • Nouveau format JSON

​
Similarités

Authentification Les endpoints de recherche de Likes (Likes lookup) des versions standard v1.1 et X API v2 utilisent tous deux OAuth 1.0a User Context ou OAuth 2.0 Bearer Token. Par conséquent, si vous utilisiez auparavant les endpoints standard v1.1 GET favorites/list endpoints, vous pouvez continuer à utiliser la même méthode d’authentification si vous migrez vers la version X API v2, si vous le souhaitez.  En fonction de la bibliothèque ou du package d’authentification de votre choix, l’authentification par Jeton Bearer est probablement la manière 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 tranche de 15 minutes et par utilisateur. L’endpoint v2 correspondant pour les Publications aimées possède également cette même limite de taux. Cependant, cet endpoint v2 dispose aussi d’une limite de taux supplémentaire de 75 requêtes par tranche de 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 Publications par requête, mais vous pouvez demander tous les likes d’une Publication à l’aide de jetons de pagination. L’endpoint v1.1 GET favorites/list vous permet également de récupérer tous les likes de Publications, mais vous pouvez en récupérer de 20 à 200 par requête. Pour l’endpoint v2 liking users, vous êtes limité à 100 liking users par Publication.    Exigences pour l’App et le Project Les endpoints X API v2 exigent que vous utilisiez des identifiants issus 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 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). X API v2 n’accepte que l’identifiant numérique de l’utilisateur, qui doit être transmis dans le chemin de l’endpoint. L’une des plus grandes différences entre les versions d’endpoints standard v1.1 et X API v2 réside dans la façon dont vous sélectionnez les champs qui seront renvoyés dans votre payload. Pour les endpoints standard, il existait plusieurs paramètres que vous pouviez utiliser pour identifier quels champs ou ensembles de champs seraient 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 nouvelles structures 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 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 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 vides (par exemple null) ne sont pas écrites 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 les éléments suivants :

​
Exemples de code

​
Récupérer les Publications aimées (v2)

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

​
Récupérer les utilisateurs ayant aimé une Publication (v2)

cURL
curl "https://api.x.com/2/tweets/1234567890/liking_users?user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"