Guía de integración

Conceptos clave y prácticas recomendadas para integrar endpoints de bloqueos

Esta guía aborda los conceptos clave que necesitas conocer para integrar los endpoints de bloqueos en tu aplicación.

---

Autenticación

Los endpoints de bloqueos requieren autenticación de usuario:

Método	Descripción
OAuth 2.0 Authorization Code with PKCE	Recomendado para nuevas aplicaciones
OAuth 1.0a User Context	Compatibilidad heredada

La autenticación de solo App no es compatible. Debes autenticarte en nombre de un usuario.

Scopes requeridos (OAuth 2.0)

Scope	Requerido para
block.read	Obtener cuentas bloqueadas
block.write	Bloquear y desbloquear cuentas
users.read	Requerido con los scopes de bloqueo

---

Descripción general de los endpoints

Método	Endpoint	Descripción
GET	/2/users/:id/blocking	Obtener la lista de cuentas bloqueadas
POST	/2/users/:id/blocking	Bloquear una cuenta
DELETE	/2/users/:source_user_id/blocking/:target_user_id	Desbloquear una cuenta

---

Campos y expansions

Respuesta predeterminada

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

Campos disponibles

user.fields

Campo	Descripción
created_at	Fecha de creación de la cuenta
description	Biografía del usuario
profile_image_url	URL del avatar
public_metrics	Recuentos de seguidores y seguidos
verified	Estado de verificación

expansions

Expansión	Descripción
pinned_tweet_id	Publicación fijada del usuario

---

Qué ocurre cuando bloqueas

No pueden

• Ver tus Publicaciones (a menos que no hayan iniciado sesión)
• Seguirte
• Enviarte MD
• Añadirte a Listas
• Etiquetarte en fotos

No puedes

• Ver sus Publicaciones
• Seguirles
• Enviarles MD

Cuando bloqueas a alguien que te sigue, esa persona deja de seguirte automáticamente.

---

Paginación

Para los usuarios con listas de bloqueo muy extensas, los resultados se dividen en páginas:

cURL

shellscript

# Primera solicitud
curl "https://api.x.com/2/users/123/blocking?max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

# Solicitud posterior con token de paginación
curl "https://api.x.com/2/users/123/blocking?max_results=100&pagination_token=NEXT_TOKEN" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

---

Gestión de errores

Estado	Error	Solución
400	Solicitud no válida	Comprueba el formato del id de usuario
401	No autorizado	Comprueba el token de acceso
403	Prohibido	Comprueba los scopes y los permisos
404	No encontrado	El usuario no existe
429	Demasiadas solicitudes	Espera y vuelve a intentarlo

---

Próximos pasos

Inicio rápido

Realiza tu primera solicitud de bloqueos

Silenciar

Silencia usuarios en lugar de bloquearlos

Referencia de la API

Documentación completa del endpoint

Código de ejemplo

Ejemplos de código funcional