Guide d’intégration

Concepts clés et bonnes pratiques pour intégrer les endpoints de blocage

Ce guide couvre les principaux concepts nécessaires pour intégrer les endpoints Blocks à votre application.

---

Authentification

Les endpoints Blocks nécessitent une authentification utilisateur :

Méthode	Description
OAuth 2.0 Authorization Code with PKCE	Recommandé pour les nouvelles applications
OAuth 1.0a User Context	Pour la compatibilité avec l’ancien système

L’authentification App-Only n’est pas prise en charge. Vous devez vous authentifier pour le compte d’un utilisateur.

Scopes requis (OAuth 2.0)

Scope	Requis pour
block.read	Récupération des comptes bloqués
block.write	Blocage et déblocage de comptes
users.read	Nécessaire avec les scopes de blocage

---

Vue d’ensemble des endpoints

Method	Endpoint	Description
GET	/2/users/:id/blocking	Obtenir la liste des comptes bloqués
POST	/2/users/:id/blocking	Bloquer un compte
DELETE	/2/users/:source_user_id/blocking/:target_user_id	Débloquer un compte

---

Champs et expansions

Réponse par défaut

{
  "data": [
    {
      "id": "1234567890",
      "name": "Example User",
      "username": "example"
    }
  ]
}

Champs disponibles

user.fields

Champ	Description
created_at	Date de création du compte
description	Biographie de l’utilisateur
profile_image_url	URL de l’avatar
public_metrics	Nombre d’abonnés et d’abonnements
verified	Statut de vérification

expansions

Expansion	Description
pinned_tweet_id	Publication épinglée de l’utilisateur

---

Ce qui se passe lorsque vous bloquez

Ils ne peuvent pas

• Voir vos Publications (sauf s’ils sont déconnectés)
• Vous suivre
• Vous envoyer des DM
• Vous ajouter à des Listes
• Vous identifier sur des photos

Vous ne pouvez pas

• Voir leurs Publications
• Les suivre
• Leur envoyer des DM

Lorsque vous bloquez quelqu’un qui vous suit, cette personne est automatiquement désabonnée de votre compte.

---

Pagination

Pour les utilisateurs disposant de longues listes de comptes bloqués, les résultats sont paginés :

cURL

shellscript

# Première requête
curl "https://api.x.com/2/users/123/blocking?max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

# Requête suivante avec jeton de pagination
curl "https://api.x.com/2/users/123/blocking?max_results=100&pagination_token=NEXT_TOKEN" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

---

Gestion des erreurs

Code	Erreur	Solution
400	Requête invalide	Vérifiez le format de l’identifiant utilisateur
401	Non autorisé	Vérifiez le jeton d’accès
403	Accès interdit	Vérifiez les étendues (scopes) et les autorisations
404	Introuvable	L’utilisateur n’existe pas
429	Trop de requêtes	Attendez puis réessayez

---

Prochaines étapes

Démarrage rapide

Envoyez votre première requête de blocage

Masquage

Masquez des utilisateurs au lieu de les bloquer

Référence de l’API

Documentation complète de ce point de terminaison

Exemple de code

Exemples de code prêts à l’emploi