Guía de integración

Esta guía presenta los conceptos clave necesarios para integrar los endpoints de mutes en tu aplicación.

Autenticación

Los endpoints de Mutes requieren autenticación de usuario para acceder a listas de silenciamiento privadas:

Method	Description
OAuth 2.0 Authorization Code with PKCE	Recomendado para nuevas aplicaciones
OAuth 1.0a User Context	Compatibilidad heredada

La autenticación App-Only no se admite. Debes autenticarte en nombre de un usuario.

Permisos requeridos (OAuth 2.0)

Permiso	Requerido para
`mute.read`	Obtener cuentas silenciadas
`mute.write`	Silenciar y dejar de silenciar cuentas
`users.read`	Requerido junto con los permisos de silencio

Descripción general de los endpoints

Método	Endpoint	Descripción
GET	`/2/users/:id/muting`	Obtener la lista de cuentas silenciadas
POST	`/2/users/:id/muting`	Silenciar una cuenta
DELETE	`/2/users/:source_user_id/muting/:target_user_id`	Dejar de silenciar 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`	Cantidad de seguidores/seguidos
`verified`	Estado de verificación

expansions

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

Ejemplo con campos

cURL

curl "https://api.x.com/2/users/123456789/muting?\
user.fields=username,verified,created_at&\
max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Obtener usuarios silenciados con campos adicionales
for page in client.users.get_muting(
    user_id="123456789",
    user_fields=["username", "verified", "created_at"],
    max_results=100
):
    for user in page.data:
        print(f"{user.username} - Verificado: {user.verified}")

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

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

const paginator = client.users.getMuting("123456789", {
  userFields: ["username", "verified", "created_at"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((user) => {
    console.log(`${user.username} - Verificado: ${user.verified}`);
  });
}

Paginación

Para los usuarios con listas de cuentas silenciadas muy extensas, los resultados se paginan:

cURL

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

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

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

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

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

print(f"Se han silenciado {len(all_muted)} cuentas")

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

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

async function getAllMutedUsers(userId) {
  const allMuted = [];

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

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

  return allMuted;
}

// Uso
const muted = await getAllMutedUsers("123");
console.log(`Se han silenciado ${muted.length} cuentas`);

Guía de paginación

Obtén más información sobre la paginación

Diferencias en el comportamiento

Silenciar vs Bloquear

Característica	Silenciar	Bloquear
Ver sus Publicaciones	No (ocultas)	No
Pueden ver tus Publicaciones	Sí	No
Pueden seguirte	Sí (pueden seguir)	No (se elimina)
Pueden enviarte MD	Sí	No
Notificación enviada	No	No

Silenciar es privado: el usuario silenciado no recibe ninguna notificación ni tiene forma de saber que ha sido silenciado.

Manejo de errores

Status	Error	Solution
400	Solicitud no válida	Verifica el formato del id de usuario
401	No autorizado	Verifica el token de acceso
403	Prohibido	Verifica 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 para silenciar

Bloqueos

Bloquea usuarios en lugar de silenciarlos

Referencia de la API

Documentación completa del endpoint

Código de ejemplo

Ejemplos de código funcional

Descripción general

Publicaciones

Usuarios

Mensajes directos

Me gusta

Listas

Spaces

Comunidades

Notas de la comunidad

Tendencias

Noticias

Contenido multimedia

Actividad en X

Uso

Conexiones de streaming

Cumplimiento

Enterprise v2

Flujos de Me gusta

GNIP 2.0

Guía de integración

Autenticación

Permisos requeridos (OAuth 2.0)

Descripción general de los endpoints

Campos y expansions

Respuesta predeterminada

Campos disponibles

Ejemplo con campos

Guía de paginación

Diferencias en el comportamiento

Silenciar vs Bloquear

Manejo de errores

Próximos pasos

Inicio rápido

Bloqueos

Referencia de la API

Código de ejemplo