Gérer les J’aime

Gérer les Likes : standard v1.1 par rapport à X API v2

Si vous avez travaillé avec les endpoints standard v1.1 POST favorites/create et POST favorites/destroy, l’objectif de ce guide est de vous aider à comprendre les similarités et les différences entre les endpoints de gestion des Likes du standard v1.1 et de X API v2.

• Similarités
  • Contexte utilisateur OAuth 1.0a
• Différences
  • URL des endpoints et méthodes HTTP
  • Exigences liées à l’App et au Project
  • Paramètres de la requête

Similarités

Méthode d’authentification OAuth 1.0a User Context

Les deux versions d’endpoint prennent en charge OAuth 1.0a User Context. Par conséquent, si vous utilisiez auparavant l’un des endpoints standard v1.1 pour gérer les favoris, vous pouvez continuer à utiliser la même méthode d’authentification si vous migrez vers la version X API v2.

Différences

URLs d’endpoint et méthodes HTTP

• Endpoints Standard v1.1 :
  • POST https://api.x.com/1.1/favorites/create.json (ajouter un J’aime à une Publication)
  • POST https://api.x.com/1.1/favorites/destroy.json (retirer un J’aime d’une Publication)
• Endpoint X API v2 :
  • POST https://api.x.com/2/tweets/:id/likes (ajouter un J’aime à une Publication)
  • DELETE https://api.x.com/2/tweets/:id/likes/:tweet_id (retirer un J’aime d’une Publication) 

Exigences pour les Apps et les Projects

Les endpoints X API v2 exigent que vous utilisiez des identifiants issus 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 à une App.

Paramètres de requête

Les paramètres de requête Standard v1.1 suivants ont des équivalents dans X API v2 :

Standard v1.1	X API v2
id	id
includes_entities	Aucun équivalent

Veuillez noter que les paramètres Standard v1.1 sont transmis sous forme de paramètres de requête, tandis que les paramètres X API v2 sont transmis sous forme de paramètres de corps de requête pour l’endpoint POST ou de paramètres de chemin pour l’endpoint DELETE.

De plus, un id de l’utilisateur qui aime une Publication n’est pas requis lorsque vous utilisez les endpoints Standard v1.1, car les Access Tokens transmis avec OAuth 1.0a User Context permettent de déduire quel utilisateur initie l’ajout ou le retrait du J’aime.

---

Exemples de code

Aimer une publication (v2)

cURL

shellscript

curl -X POST "https://api.x.com/2/users/123456789/likes" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "1234567890"}'

Retirer un J’aime d’une Publication (v2)

cURL

shellscript

curl -X DELETE "https://api.x.com/2/users/123456789/likes/1234567890" \
  -H "Authorization: OAuth ..."