Introduction

Les endpoints de gestion des blocages de DM vous permettent de bloquer ou de débloquer un compte donné au nom d’un utilisateur authentifié. Pour ces endpoints, deux méthodes POST sont disponibles :

• /2/users/:id/dm/block : permet de bloquer un compte
• /2/users/:id/dm/unblock : permet de débloquer un compte

​

Prise en main

​

Authentification

Comme vous effectuez des requêtes pour le compte d’un utilisateur, vous devez authentifier ces endpoints avec Contexte utilisateur OAuth 1.0a ou OAuth 2.0 Autorisation par code avec PKCE, et utiliser les Access Tokens de l’utilisateur au nom duquel vous effectuez la requête. Vous pouvez générer cet Access Token utilisateur à l’aide du flux OAuth à 3 étapes (OAuth 1.0a) ou du flux d’Autorisation par code avec PKCE (OAuth 2.0).

​

Effectuer une requête

Bloquer

Une fois qu’un utilisateur s’est authentifié auprès de votre App, vous pouvez appeler l’endpoint Block en son nom, comme indiqué ci-dessous :

      curl --request POST 'https://api.x.com/2/users/:id/dm/block' --header 'Authorization: ••••••'

Si la requête aboutit, vous devriez voir la réponse JSON ci-dessous :

{
   "data": {
       "blocked": true
   }
}

Débloquer

Une fois qu’un utilisateur s’est authentifié auprès de votre App, vous pouvez appeler l’endpoint Unblock pour le compte de l’utilisateur, comme indiqué ci‑dessous :

      curl --request POST 'https://api.x.com/2/users/:id/dm/unblock' --header 'Authorization: ••••••'

Si la requête réussit, vous devriez voir la réponse JSON comme indiqué ci-dessous :

{
   "data": {
       "blocked": false
   }
}