v1 vers v2

Standard v1.1 par rapport à X API v2

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

Similarités
- Authentification
Différences
- URL des endpoints
- Exigences relatives aux App et aux Projets
- Paramètres de requête

Similarités

Authentification Les endpoints standard de la v1.1 et de X API v2 qui gèrent les Publications (POST statuses/update et POST statuses/destroy/:id) utilisent OAuth 1.0a User Context. Par conséquent, si vous utilisiez précédemment l’un des endpoints standard v1.1, 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 :
- https://api.x.com/1.1/statuses/update.json (Crée une Publication)
- https://api.x.com/1.1/statuses/destroy/:id.json (Supprime une Publication)
Endpoint X API v2 :
- https://api.x.com/2/tweets (Crée une Publication)
- https://api.x.com/2/tweets/:id (Supprime une Publication donnée)

Conditions requises pour les Apps et les Projects

Les endpoints de X API v2 requièrent l’utilisation d’identifiants issus d’une App développeur associée à un Project pour authentifier vos requêtes. Tous les endpoints de X API v1.1 peuvent utiliser des identifiants provenant d’Apps, qu’elles soient ou non associées à un Project.

Paramètres de requête

Les paramètres de requête standard de la v1.1 suivants acceptaient deux paramètres de requête (user_id ou screen_name). X API v2 n’accepte que l’id numérique de la Publication pour l’endpoint DELETE, qui doit être transmis dans le chemin de l’endpoint. Pour l’endpoint POST, des paramètres supplémentaires doivent être transmis dans le corps JSON de la requête. Vous pouvez en apprendre davantage sur les paramètres disponibles dans le guide de référence de l’API.

Exemples de code

Créer une Publication (v2)

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world!"}'

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 publication
response = client.posts.create(text="Hello world!")
print(f"Publication 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 publication
const response = await client.posts.create({ text: "Hello world!" });
console.log(`Publication créée : ${response.data?.id}`);

Supprimer une publication (v2)