> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Guía de integración
> Esta guía cubre los conceptos clave que necesitas para integrar los endpoints de bloqueos. Referencia del nivel estándar de X API v2 para bloqueos.
export const Button = ({href, children}) => {
return ;
};
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í](/forms/enterprise-api-interest).
***
## Autenticación
Los endpoints de bloqueos requieren autenticación de usuario:
| Método | Descripción |
| :----------------------------------------------------------------------------------------------------------------------------- | :----------------------------------- |
| [OAuth 2.0 Authorization Code with PKCE](/resources/fundamentals/authentication#oauth-2-0-authorization-code-flow-with-pkce-2) | Recomendado para nuevas aplicaciones |
| [OAuth 1.0a User Context](/resources/fundamentals/authentication) | 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
```json theme={null}
{
"data": [
{
"id": "1234567890",
"name": "Example User",
"username": "example"
}
]
}
```
### Fields disponibles
| 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 |
| Expansion | Descripción |
| :---------------- | :---------------------- |
| `pinned_tweet_id` | Post fijado del usuario |
***
## Qué sucede cuando bloqueas
* Ver tus Posts (a menos que hayan cerrado sesión)
* Seguirte
* Enviarte DMs
* Añadirte a Listas
* Etiquetarte en fotos
* 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:
```bash cURL theme={null}
# 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"
```
```python title="Python SDK" lines wrap icon="python" theme={null}
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")
```
```javascript title="JavaScript SDK" lines wrap icon="square-js" theme={null}
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](/forms/enterprise-api-interest) |
| 404 | Not Found | El usuario no existe |
| 429 | Too Many Requests | Espera y reintenta |
***
## Próximos pasos
Realiza tu primera solicitud de bloqueos
Silencia usuarios en lugar de bloquear
Documentación completa del endpoint
Ejemplos de código funcionales