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

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

# Nécessite une authentification OAuth 1.0a dans le 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/users/123456789/following"
response = requests.post(url, auth=auth, json={"target_user_id": "2244994945"})
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)

# Suivre un utilisateur
response = client.users.follow(
    source_user_id="123456789",
    target_user_id="2244994945"
)
print(f"Following: {response.data.following}")

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 });

// Suivre un utilisateur
const response = await client.users.follow("123456789", {
  targetUserId: "2244994945",
});
console.log(`Following: ${response.data?.following}`);

Ne plus suivre un utilisateur (v2)

cURL

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

# 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/users/123456789/following/2244994945"
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)

# Ne plus suivre un utilisateur
response = client.users.unfollow(
    source_user_id="123456789",
    target_user_id="2244994945"
)
print(f"Following: {response.data.following}")

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 });

// Ne plus suivre un utilisateur
const response = await client.users.unfollow("123456789", "2244994945");
console.log(`Following: ${response.data?.following}`);

Getting Started

Fundamentals

Partners & Customers

Resources