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

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"}'

# Nécessite une authentification OAuth 1.0a dans un contexte utilisateur
import requests
from requests_oauthlib import OAuth1

auth = OAuth1(
    "API_KEY", "API_SECRET",
    "ACCESS_TOKEN", "ACCESS_TOKEN_SECRET"
)

url = "https://api.x.com/2/lists"
data = {"name": "My List", "description": "A great list"}

response = requests.post(url, auth=auth, json=data)
print(response.json())

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Créer une Liste
response = client.lists.create(name="My List", description="A great list")
print(f"Liste créée : {response.data.id}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Créer une Liste
const response = await client.lists.create({
  name: "My List",
  description: "A great list",
});
console.log(`Liste créée : ${response.data?.id}`);

Supprimer une liste (v2)

cURL

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

# Nécessite une authentification OAuth 1.0a avec contexte utilisateur (User Context)
import requests
from requests_oauthlib import OAuth1

auth = OAuth1(
    "API_KEY", "API_SECRET",
    "ACCESS_TOKEN", "ACCESS_TOKEN_SECRET"
)

url = "https://api.x.com/2/lists/123456789"
response = requests.delete(url, auth=auth)
print(response.json())

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Supprimer une liste
response = client.lists.delete("123456789")
print(f"Deleted: {response.data.deleted}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Supprimer une liste
const response = await client.lists.delete("123456789");
console.log(`Deleted: ${response.data?.deleted}`);

Getting Started

Fundamentals

Partners & Customers

Resources

v1 vers v2

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

Similarités

Différences

Exemples de code

Créer une Liste (v2)

Supprimer une liste (v2)