Guía de integración

Conceptos clave y prácticas recomendadas para integrar los endpoints de silencios

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

shellscript

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

---

​

Paginación

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

cURL

shellscript

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

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