v1 vers v2

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

Si vous utilisez déjà les endpoints standard v1.1 POST lists/create, POST lists/destroy et POST lists/update, l’objectif de ce guide est de vous aider à comprendre les similarités et les différences entre les endpoints de gestion des Listes de la version standard v1.1 et ceux de X API v2.

• Similarités
  • Authentification
• Différences
  • URL des endpoints
  • Exigences liées à l’App et au Project
  • Méthodes HTTP
  • Limites de taux
  • Paramètres de requête

Similarités

Authentification

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

Différences

URL d’endpoint

• Endpoints Standard v1.1 :
  • POST https://api.x.com/1.1/lists/create.json (Crée une Liste)
  • POST https://api.x.com/1.1/lists/destroy.json (Supprime une Liste)
  • POST https://api.x.com/1.1/lists/update.json (Met à jour une Liste)
• Endpoint X API v2 :

  • POST https://api.x.com/2/lists (Crée une Liste)

  • DELETE https://api.x.com/2/lists/:id (Supprime une Liste)

  • PUT https://api.x.com/2/lists/:id (Met à jour une Liste)

Limites de taux

Standard v1.1	X API v2
/1.1/lists/create.json aucune	/2/lists 300 requêtes par fenêtre de 15 minutes avec un contexte utilisateur OAuth 1.0a
/1.1/lists/destroy.json aucune	/2/lists/:id 300 requêtes par fenêtre de 15 minutes avec un contexte utilisateur OAuth 1.0a
/1.1/lists/update.json aucune	/2/lists/:id 300 requêtes par fenêtre de 15 minutes avec un contexte utilisateur OAuth 1.0a

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 ou d’Apps associées à un Project.

Paramètres de la requête

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

Créer une Liste

Standard	X API v2
name	name
mode	private
description	description

Supprimer/mettre à jour une Liste

Standard	X API v2
owner_screen_name	Aucun équivalent
owner_id	Aucun équivalent
list_id	id
slug	Aucun équivalent

Veuillez noter : 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 les endpoints DELETE et PUT).

---

Exemples de code

Créer une Liste (v2)

cURL

shellscript

curl -X POST "https://api.x.com/2/lists" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"name": "My List", "description": "A great list"}'

Supprimer une liste (v2)

cURL

shellscript

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