Démarrage rapide

Bloquer et débloquer des utilisateurs, et récupérer votre liste de blocage

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

Prérequis

Avant 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

1. 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.

2. Récupérer votre liste de blocage

   cURL

   shellscript

   curl "https://api.x.com/2/users/123456789/blocking?\
   user.fields=username,verified,created_at&\
   max_results=100" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN"
   
3. 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

1. Identifier l’utilisateur cible

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

2. Envoyer une requête de blocage

   cURL

   shellscript

   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"}'
   
3. Confirmer le blocage

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

---

​

Débloquer un utilisateur

1. Envoyer une requête de déblocage

   cURL

   shellscript

   curl -X DELETE "https://api.x.com/2/users/123456789/blocking/9876543210" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN"
   
2. 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