Gérer les Retweets

Gérer les Retweets : Standard v1.1 par rapport à X API v2

Si vous avez travaillé avec les endpoints standard v1.1 POST statuses/retweet/:id et POST statuses/unretweet/:id, l’objectif de ce guide est de vous aider à comprendre les similitudes et les différences entre les endpoints de Retweets standard et ceux de X API v2.

• Similarités
  • Authentification
• Différences
  • URL des endpoints et méthodes HTTP
  • Limitations des requêtes
  • Exigences relatives aux Apps et Projects
  • Paramètres de requête

Similarities

Authentification

Les endpoints standard v1.1 et X API v2 de gestion des Retweets (POST statuses/retweet/:id et POST statuses/unretweet/:id) utilisent tous deux le contexte utilisateur OAuth 1.0a. Par conséquent, si vous utilisiez auparavant l’un des endpoints standard v1.1 de recherche de Retweets, vous pouvez continuer à utiliser la même méthode d’authentification lors de votre migration vers la version X API v2 correspondante. 

Différences

URLs d’endpoint et méthodes HTTP

• Endpoints standard v1.1 :
  • https://api.x.com/1.1/statuses/retweet/:id.json (Retweete une Publication. Retourne la Publication d’origine avec les détails du Retweet intégrés)
  • https://api.x.com/1.1/statuses/unretweet/:id.json (Annule un Retweet. Retourne la Publication d’origine avec les détails du Retweet intégrés)
• Endpoint X API v2 :
  • https://api.x.com/2/tweets/:id/retweets (Retweete une Publication donnée)
  • https://api.x.com/2/users/:id/retweets/:source_tweet_id (Annule un Retweet d’une Publication donnée) 

Exigences relatives à l’App et au Project

Les endpoints X API v2 exigent que vous utilisiez des 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 provenant d’Apps, qu’elles soient autonomes ou associées à une App.

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’identifiant utilisateur numérique, qui doit être transmis dans le chemin de l’endpoint.

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

Veuillez noter que les paramètres standard v1.1 sont transmis en tant que paramètres de requête, tandis que les paramètres X API v2 sont transmis en tant que paramètres dans le corps pour l’endpoint POST ou en tant que paramètres de chemin pour l’endpoint DELETE.

De plus, l’id de l’utilisateur qui retweete une Publication n’est pas requis lors de l’utilisation des endpoints standard v1.1, puisque les Access Tokens transmis avec le OAuth 1.0a User Context permettent de déterminer quel utilisateur initie le Retweet ou annule un Retweet.

---

Exemples de code

Retweeter une publication (v2)

cURL

shellscript

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

Annuler un Retweet (v2)

cURL

shellscript

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