Démarrage rapide

Ce guide vous explique comment bloquer et débloquer des utilisateurs, et récupérer votre liste de comptes bloqués.

PrérequisAvant de commencer, vous aurez besoin de :

D’un compte développeur avec une App approuvée
D’un jeton d’accès utilisateur (OAuth 1.0a ou OAuth 2.0 PKCE)

Récupérer les utilisateurs bloqués

Récupérer votre ID utilisateur

Vous avez besoin de l’ID de votre utilisateur authentifié pour récupérer votre liste de blocage. Vous pouvez l’obtenir à partir de l’endpoint /2/users/me ou utiliser l’ID présent dans vos jetons.

Récupérer votre liste de blocage

cURL

curl "https://api.x.com/2/users/123456789/blocking?\
user.fields=username,verified,created_at&\
max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Récupérer les utilisateurs bloqués avec pagination
for page in client.users.get_blocking(
    "123456789",
    user_fields=["username", "verified", "created_at"],
    max_results=100
):
    for user in page.data:
        print(f"{user.username} - Created: {user.created_at}")

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

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Récupérer les utilisateurs bloqués avec pagination
const paginator = client.users.getBlocking("123456789", {
  userFields: ["username", "verified", "created_at"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((user) => {
    console.log(`${user.username} - Created: ${user.created_at}`);
  });
}

Examiner la réponse

{
  "data": [
    {
      "id": "17874544",
      "name": "Example User",
      "username": "example_user",
      "verified": false,
      "created_at": "2008-12-04T18:51:57.000Z"
    }
  ],
  "meta": {
    "result_count": 1,
    "next_token": "abc123"
  }
}

Bloquer un utilisateur

Identifier l’utilisateur cible

Récupérez l’ID utilisateur du compte que vous souhaitez bloquer.

Envoyer une requête de blocage

cURL

curl -X POST "https://api.x.com/2/users/123456789/blocking" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target_user_id": "9876543210"}'

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)

# Bloquer un utilisateur
response = client.users.block(
    source_user_id="123456789",
    target_user_id="9876543210"
)
print(f"Blocking: {response.data.blocking}")

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

// Bloquer un utilisateur
const response = await client.users.block("123456789", {
  targetUserId: "9876543210",
});
console.log(`Blocking: ${response.data?.blocking}`);

Confirmer le blocage

{
  "data": {
    "blocking": true
  }
}

Débloquer un utilisateur

Envoyer une requête de déblocage

cURL

curl -X DELETE "https://api.x.com/2/users/123456789/blocking/9876543210" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

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)

# Débloquer un utilisateur
response = client.users.unblock(
    source_user_id="123456789",
    target_user_id="9876543210"
)
print(f"Blocking: {response.data.blocking}")

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

// Débloquer un utilisateur
const response = await client.users.unblock("123456789", "9876543210");
console.log(`Blocking: ${response.data?.blocking}`);

Confirmer le déblocage

{
  "data": {
    "blocking": false
  }
}

Prochaines étapes

Sourdines

Mettre des comptes en sourdine plutôt que de les bloquer

Abonnements

Gérer les abonnements

Guide d’intégration

Concepts clés et bonnes pratiques

Référence de l’API

Documentation complète du point de terminaison

Vue d’ensemble

Publications

Utilisateurs

Messages privés

Mentions J’aime

Listes

Espaces

Communautés

Notes de la communauté

Tendances

Actualités

Médias

Activité sur X

Utilisation

Connexions de flux

Conformité

Enterprise v2

Flux des J’aime

GNIP 2.0

Démarrage rapide

Récupérer les utilisateurs bloqués

Bloquer un utilisateur

Débloquer un utilisateur

Prochaines étapes

Sourdines

Abonnements

Guide d’intégration

Référence de l’API