v1 vers v2

Gérer les abonnements : standard v1.1 comparé à X API v2

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

• Similarités
  • Contexte utilisateur OAuth 1.0a
• Différences
  • URL des endpoints
  • Exigences relatives aux Apps et aux projets
  • Méthodes HTTP
  • Paramètres de requête

Similitudes

Méthode d’authentification OAuth 1.0a en contexte utilisateur

Les deux versions de l’endpoint prennent en charge OAuth 1.0a en contexte utilisateur. Par conséquent, si vous utilisiez auparavant l’un des endpoints standard v1.1 de gestion des abonnements, vous pouvez continuer à utiliser la même méthode d’authentification si vous migrez vers la version X API v2.

Différences

URL des endpoints

• Endpoints Standard v1.1 :
  • POST https://api.x.com/1.1/friendships/create.json (suivre un utilisateur)
  • POST https://api.x.com/1.1/friendships/destroy.json (ne plus suivre un utilisateur)
• Endpoint X API v2 :
  • POST https://api.x.com/2/users/:id/following (suivre un utilisateur)
  • DELETE https://api.x.com/2/users/:source_user_id/following/:target_user_id (ne plus suivre un utilisateur)

Exigences relatives à l’App et au 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 ou d’Apps associées à un Project.

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
Aucun équivalent	id (POST), source_user_id (DELETE)
user_id	target_user_id
screen_name	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 dans le corps de la requête (pour l’endpoint POST) ou dans le chemin (pour l’endpoint DELETE).

De plus, les champs v2 id et source_user_id ne sont pas requis lors de l’utilisation des endpoints Standard v1.1, car les Access Tokens transmis avec le contexte utilisateur OAuth 1.0a permettaient de déterminer quel utilisateur initiait l’action de suivre/ne plus suivre.

---

Exemples de code

Suivre un utilisateur (v2)

cURL

shellscript

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

Ne plus suivre un utilisateur (v2)

cURL

shellscript

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