Guía de integración

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

Los endpoints para bloquear y desbloquear usuarios solo están disponibles en el plan Enterprise. Puedes completar el formulario de interés Enterprise aquí.

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	Soporte heredado

La autenticación App-Only 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 scopes de bloqueo

Resumen de endpoints

Método	Endpoint	Descripción	Disponibilidad
GET	`/2/users/:id/blocking`	Obtiene la lista de cuentas bloqueadas	Pay-per-useEnterprise
POST	`/2/users/:id/blocking`	Bloquea una cuenta	Enterprise
DELETE	`/2/users/:source_user_id/blocking/:target_user_id`	Desbloquea una cuenta	Enterprise

Fields y expansions

Respuesta predeterminada

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

Fields disponibles

user.fields

Field	Descripción
`created_at`	Fecha de creación de la cuenta
`description`	Bio del usuario
`profile_image_url`	URL del avatar
`public_metrics`	Recuentos de seguidores/seguidos
`verified`	Estado de verificación

expansions

Expansion	Descripción
`pinned_tweet_id`	Post fijado del usuario

Qué sucede cuando bloqueas

Ellos no pueden

Ver tus Posts (a menos que hayan cerrado sesión)
Seguirte
Enviarte DMs
Añadirte a Listas
Etiquetarte en fotos

Tú no puedes

Ver sus Posts
Seguirlos
Enviarles DMs

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

Paginación

Para usuarios con listas de bloqueo grandes, los resultados están paginados:

cURL

# 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"

from xdk import Client

# Usa el token de acceso de usuario de OAuth 2.0
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# El SDK gestiona la paginación automáticamente
all_blocked = []

for page in client.users.get_blocking(user_id="123", max_results=100):
    if page.data:
        all_blocked.extend(page.data)

print(f"Blocked {len(all_blocked)} users")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

async function getAllBlockedUsers(userId) {
  const allBlocked = [];

  // El SDK gestiona la paginación automáticamente
  const paginator = client.users.getBlocking(userId, { maxResults: 100 });

  for await (const page of paginator) {
    if (page.data) {
      allBlocked.push(...page.data);
    }
  }

  return allBlocked;
}

// Uso
const blocked = await getAllBlockedUsers("123");
console.log(`Blocked ${blocked.length} users`);

Gestión de errores

Estado	Error	Solución
400	Invalid request	Verifica el formato del ID de usuario
401	Unauthorized	Verifica el token de acceso
403	Forbidden	Verifica scopes y permisos. Bloquear/desbloquear requieren Enterprise
404	Not Found	El usuario no existe
429	Too Many Requests	Espera y reintenta

Próximos pasos

Inicio rápido

Realiza tu primera solicitud de bloqueos

Silencios

Silencia usuarios en lugar de bloquear

Referencia de la API

Documentación completa del endpoint

Código de ejemplo

Ejemplos de código funcionales

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Guía de integración

Autenticación

Scopes requeridos (OAuth 2.0)

Resumen de endpoints

Fields y expansions

Respuesta predeterminada

Fields disponibles

Qué sucede cuando bloqueas

Ellos no pueden

Tú no puedes

Paginación

Gestión de errores

Próximos pasos

Inicio rápido

Silencios

Referencia de la API

Código de ejemplo

​Autenticación

​Scopes requeridos (OAuth 2.0)

​Resumen de endpoints

​Fields y expansions

​Respuesta predeterminada

​Fields disponibles

​Qué sucede cuando bloqueas

Ellos no pueden

Tú no puedes

​Paginación

​Gestión de errores

​Próximos pasos

Inicio rápido

Silencios

Referencia de la API

Código de ejemplo

Autenticación

Scopes requeridos (OAuth 2.0)

Resumen de endpoints

Fields y expansions

Respuesta predeterminada

Fields disponibles

Qué sucede cuando bloqueas

Paginación

Gestión de errores

Próximos pasos