Introducción

Los endpoints para gestionar los bloqueos de MD te permiten bloquear o desbloquear una cuenta determinada en nombre de un usuario autenticado. Para estos endpoints, hay dos métodos POST disponibles:

• /2/users/:id/dm/block: Permite bloquear una cuenta
• /2/users/:id/dm/unblock: Permite desbloquear una cuenta

Primeros pasos

Autenticación

Dado que estás realizando solicitudes en nombre de un usuario, debes autenticar estos endpoints con OAuth 1.0a User Context o OAuth 2.0 Authorization Code with PKCE, y utilizar los tokens de acceso de usuario asociados con el usuario en cuyo nombre estás realizando la solicitud. Puedes generar este token de acceso de usuario utilizando el flujo OAuth de 3 etapas (OAuth 1.0a) o utilizando el flujo de concesión de código de autorización con PKCE (OAuth 2.0).

Realizar una solicitud

Block

Una vez que un usuario se haya autenticado con tu App, puedes llamar al endpoint Block en nombre del usuario como se muestra a continuación:

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

Si la solicitud se realiza correctamente, verás la respuesta JSON como se muestra a continuación:

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

Desbloquear

Una vez que un usuario se haya autenticado en tu App, puedes llamar al endpoint Unblock en nombre de ese usuario como se muestra a continuación:

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

Si la solicitud se completa correctamente, verás la respuesta JSON que se muestra a continuación:

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