Referencia de errores de la API de ThreadsGuía completa de solución de problemas con soluciones
Referencia completa para errores de la API de Threads. Encuentra soluciones y resuelve problemas comunes de integración.
Categorías de Errores
Autenticación
3 errors
Medios
1 error
Video
3 errors
Todos los Códigos de Error
#Autenticación
revoked_access_tokenrefresh-tokenEl token de acceso de Threads no es válido o fue revocado. Vuelve a conectar tu cuenta de Threads.
Solución:
Tu token de acceso de Threads fue revocado. Esto sucede cuando eliminas los permisos de la app o la seguridad de Instagram detecta actividad sospechosa. Vuelve a conectar tu cuenta.
token is invalidrefresh-tokenEl token de acceso de Threads no es válido o fue revocado. Vuelve a conectar tu cuenta de Threads.
Solución:
Tu token ya no es válido. Los tokens de Threads están vinculados a cuentas de Instagram. Vuelve a conectar tu cuenta de Threads a través de la cuenta empresarial de Instagram.
session has been invalidatedrefresh-tokenTu sesión de Threads ha expirado. Vuelve a conectar tu cuenta de Threads.
Solución:
Tu sesión de Threads expiró. Esto puede suceder después de cambios de contraseña o verificaciones de seguridad. Vuelve a conectar tu cuenta de Threads para establecer una nueva sesión.
#Medios
media processingretryThreads todavía está procesando tus medios. Reintentando...
Solución:
Threads todavía está procesando tus medios cargados. Esto es normal y el sistema reintentará automáticamente. Los videos grandes pueden tardar más en procesarse.
#Video
video formatuser-errorFormato de video no compatible. Asegúrate de que el video esté en formato MP4 H.264/AAC.
Solución:
Threads requiere videos MP4 con códec H.264 y audio AAC. Convierte tu video a este formato usando herramientas como FFmpeg o HandBrake.
video codecuser-errorFormato de video no compatible. Asegúrate de que el video esté en formato MP4 H.264/AAC.
Solución:
Códec de video no compatible. Usa códecs H.264 (video) y AAC (audio). Evita usar HEVC/H.265 u otros códecs modernos que Threads aún no admite.
duration exceeduser-errorLa duración del video excede el límite de Threads (máximo 5 minutos).
Solución:
Los videos de Threads deben durar 5 minutos o menos. Recorta tu video para que entre en este límite. Considera dividir el contenido más largo en varias publicaciones.
Mejores Prácticas
Manejo de Errores
- →Manejar retrasos en el procesamiento de medios automáticamente
- →Validar formato de video antes de cargar
- →Monitorear expiración de tokens
- →Implementar lógica de reintento para procesamiento de medios
Consejos de Prevención
- →Usar formato MP4 H.264/AAC para videos
- →Mantener videos de menos de 5 minutos
- →Reconectar cuenta después de cambios de contraseña de Instagram
- →Esperar a que se complete el procesamiento de medios
¿Necesitas Ayuda con Threads Integración?
Nuestra API maneja escenarios de error automáticamente con lógica de reintento inteligente y registro detallado.