Referencia de errores de la API de BlueskyGuía completa de solución de problemas con soluciones

Referencia completa para errores de la API de Bluesky. Encuentra soluciones y resuelve problemas comunes de integración.

10 códigos de error
5 categorías
AT Protocol

Categorías de Errores

Autenticación

3 errors

Limitación de tasa

2 errors

Moderación

2 errors

Medios

2 errors

Contenido

1 error

Todos los Códigos de Error

#Autenticación

invalid tokenrefresh-token

La sesión de Bluesky ha expirado. Vuelve a conectar tu cuenta de Bluesky.

Solución:

Tu sesión de Bluesky ya no es válida. Bluesky usa autenticación basada en sesión. Vuelve a conectar tu cuenta para establecer una nueva sesión.

expiredrefresh-token

La sesión de Bluesky ha expirado. Vuelve a conectar tu cuenta de Bluesky.

Solución:

Tu sesión de Bluesky expiró. Las sesiones típicamente duran un tiempo limitado. Vuelve a conectar tu cuenta para obtener un nuevo token de sesión.

unauthorizedrefresh-token

La sesión de Bluesky ha expirado. Vuelve a conectar tu cuenta de Bluesky.

Solución:

Fallo de autenticación. Esto sucede cuando tu sesión expira o no es válida. Ve a la configuración de la cuenta y vuelve a conectar tu cuenta de Bluesky.

#Limitación de tasa

rate limitretry

Se alcanzó el límite de tasa de Bluesky. Inténtalo de nuevo en unos momentos.

Solución:

Has excedido los límites de tasa de Bluesky. Espera unos minutos antes de reintentar. Bluesky aplica límites de tasa para mantener la calidad del servicio.

too many requestsretry

Se alcanzó el límite de tasa de Bluesky. Inténtalo de nuevo en unos momentos.

Solución:

Demasiadas solicitudes en poco tiempo. Espacía tus solicitudes e implementa retroceso exponencial. El sistema reintentará automáticamente.

#Moderación

blockeduser-error

Contenido bloqueado por la moderación de Bluesky. Revisa las pautas de la comunidad de Bluesky.

Solución:

Tu contenido fue bloqueado por el sistema de moderación de Bluesky. Revisa las pautas de la comunidad de Bluesky y asegúrate de que tu contenido cumpla con sus políticas.

moderationuser-error

Contenido bloqueado por la moderación de Bluesky. Revisa las pautas de la comunidad de Bluesky.

Solución:

Contenido marcado por filtros de moderación. Evita publicar spam, acoso o contenido que viole las pautas de Bluesky. Revisa y modifica tu contenido.

#Medios

blob too largeuser-error

El archivo de medios es demasiado grande o inválido. Bluesky tiene límites de tamaño de archivo estrictos.

Solución:

Bluesky tiene un tamaño máximo de archivo de 1 MB para imágenes. Comprime tus imágenes para cumplir con este requisito. Usa herramientas como TinyPNG o ImageOptim.

blob invaliduser-error

El archivo de medios es demasiado grande o inválido. Bluesky tiene límites de tamaño de archivo estrictos.

Solución:

Tu archivo de medios es inválido o está corrupto. Asegúrate de que tu imagen sea un archivo JPG, PNG o WebP válido. Vuelve a exportar la imagen e inténtalo de nuevo.

#Contenido

text too longuser-error

El texto de la publicación excede el límite de caracteres de Bluesky (300 caracteres).

Solución:

Bluesky tiene un límite de 300 caracteres por publicación. Acorta tu texto o divídelo en varias publicaciones (un hilo). Sé conciso y directo.

Mejores Prácticas

Manejo de Errores

  • Implementar lógica de actualización de sesión
  • Manejar límites de tasa con retroceso exponencial
  • Validar contenido contra las pautas de la comunidad
  • Comprimir imágenes antes de cargar

Consejos de Prevención

  • Mantener publicaciones menores a 300 caracteres
  • Comprimir imágenes a menos de 1 MB
  • Seguir las pautas de la comunidad de Bluesky
  • Usar autenticación basada en sesión

¿Necesitas Ayuda con Bluesky Integración?

Nuestra API maneja escenarios de error automáticamente con lógica de reintento inteligente y registro detallado.