Referencia de Errores de la API de TikTokGuía completa de solución de problemas con soluciones
Referencia completa para errores de la API de TikTok. Encuentra soluciones para detección de spam, errores de formato de video, permisos de alcance y límites de tasa.
Categorías de Errores
Autenticación
3 errors
Spam
6 errors
Formato de video
6 errors
Medios
3 errors
Límite de tasa
2 errors
Estado de la app
3 errors
Server
2 errors
Todos los Códigos de Error
#Autenticación
access_token_invalidrefresh-tokenEl token de acceso de TikTok no es válido. Vuelve a conectar tu cuenta de TikTok.
Solución:
Tu token de acceso ya no es válido. Ve a la configuración de la cuenta y vuelve a conectar tu cuenta de TikTok para obtener un nuevo token válido.
scope_not_authorizedrefresh-tokenFaltan permisos requeridos de TikTok. Vuelve a conectar con todos los alcances requeridos.
Solución:
No otorgaste todos los permisos requeridos. Al reconectar, asegúrate de aprobar todos los alcances solicitados incluyendo video.upload y user.info.basic.
scope_permission_missedrefresh-tokenSe requieren permisos adicionales, vuelve a autenticarte.
Solución:
Se necesitan permisos adicionales para esta operación. Vuelve a conectar tu cuenta de TikTok y asegúrate de que todos los permisos estén otorgados.
#Spam
spam_risk_user_banned_from_postinguser-errorCuenta baneada de publicar. Verifica el estado de tu cuenta de TikTok.
Solución:
Tu cuenta de TikTok ha sido restringida de publicar. Inicia sesión directamente en TikTok para ver si hay advertencias. Es posible que necesites apelar la restricción.
spam_risk_textuser-errorTikTok detectó posible spam en el texto de la publicación.
Solución:
Tu descripción o texto fue marcado como spam. Evita contenido repetitivo, enlaces excesivos o lenguaje promocional. Intenta publicar contenido diferente.
spam_risk_too_many_postsuser-errorSe alcanzó el límite de publicaciones diarias. Inténtalo de nuevo mañana.
Solución:
Has excedido el límite de publicaciones diarias de TikTok. Espera 24 horas antes de publicar de nuevo. Considera espaciar tus publicaciones en varios días.
spam_risk_too_many_pending_shareuser-errorSe ha alcanzado el límite diario de carga de la API para el usuario actual.
Solución:
Para reducir el spam, TikTok limita el número de vídeos que se pueden subir a través de la API que no estén pendientes de aprobación y publicación por parte del creador. Puede haber un máximo de 5 comparticiones pendientes en un periodo de 24 horas.
spam_riskuser-errorTikTok detectó posible spam.
Solución:
El sistema de detección de spam de TikTok marcó tu contenido. Asegúrate de que tu contenido sea original y siga las pautas de la comunidad de TikTok. Evita publicaciones repetitivas.
reached_active_user_capuser-errorSe ha alcanzado la cuota de usuarios activos diarios, por favor intenta de nuevo más tarde.
Solución:
Tu aplicación ha alcanzado el límite diario de usuarios activos. Este límite está establecido por TikTok según el estado de tu aplicación. Espera 24 horas o solicita un aumento de cuota.
#Formato de video
file_format_check_faileduser-errorEl formato del archivo no es válido. Por favor, verifica las especificaciones del vídeo de TikTok.
Solución:
El formato de tu vídeo no es compatible. TikTok requiere formatos MP4 o WebM. Convierte tu vídeo y asegúrate de que cumpla con las especificaciones de TikTok.
duration_check_faileduser-errorLa duración del vídeo no es válida. Por favor, revisa las especificaciones de vídeo de TikTok.
Solución:
La duración del vídeo debe estar entre 3 segundos y 10 minutos. Recorta tu vídeo para que se ajuste a estos límites.
frame_rate_check_faileduser-errorLa tasa de fotogramas del vídeo no es válida. Por favor, revisa las especificaciones del vídeo de TikTok.
Solución:
TikTok requiere una tasa de fotogramas entre 23 y 60 fps. Vuelve a codificar tu vídeo con una tasa de fotogramas compatible.
picture_size_check_faileduser-errorEl tamaño de la imagen / vídeo no es válido, debe ser de al menos 720p.
Solución:
La resolución de tu vídeo es demasiado baja. TikTok requiere una resolución mínima de 720p. Utiliza una fuente de vídeo de mayor calidad.
video durationuser-errorLa duración del vídeo excede los límites de TikTok. Por favor, utiliza un vídeo más corto.
Solución:
Tu vídeo es demasiado largo. La duración máxima es de 10 minutos. Edita tu vídeo para que sea más corto o divídelo en varias partes.
file sizeuser-errorEl tamaño del archivo supera los límites de TikTok. Por favor, utiliza un archivo más pequeño.
Solución:
El tamaño máximo de archivo suele ser de 287 MB para vídeos. Comprime tu vídeo o reduce su calidad para ajustarte al límite de tamaño.
#Medios
video_pull_faileduser-errorNo se pudo recuperar el vídeo desde la URL. Por favor, verifica que la URL del vídeo sea accesible.
Solución:
TikTok no pudo descargar tu vídeo desde la URL proporcionada. Asegúrate de que la URL sea accesible públicamente, devuelva los encabezados correctos y que el archivo sea válido.
photo_pull_faileduser-errorNo se pudo obtener la foto de la URL. Por favor, verifica que la URL de la foto sea accesible.
Solución:
TikTok no pudo descargar tu imagen. Verifica que la URL sea accesible públicamente y que devuelva el encabezado de tipo de contenido correcto (image/jpeg o image/png).
invalid_file_uploaduser-errorFormato de archivo no válido o especificaciones no cumplidas.
Solución:
Tu archivo no cumple con los requisitos de TikTok. Asegúrate de que sea un archivo de video/imágen válido en un formato compatible y que cumpla con todas las especificaciones.
#Límite de tasa
rate_limit_exceededretrySe ha superado el límite de tasa de TikTok. Por favor, inténtalo de nuevo en unos momentos.
Solución:
Has realizado demasiadas solicitudes demasiado rápido. Espera unos minutos antes de intentarlo de nuevo. El sistema lo intentará automáticamente por ti.
too many requestsretrySe ha superado el límite de tasa de TikTok. Inténtalo de nuevo en unos momentos.
Solución:
TikTok está limitando la frecuencia de tus solicitudes. Reduce la frecuencia de las llamadas a la API e implementa un retroceso exponencial en tu lógica de reintentos.
#Estado de la app
unaudited_client_can_only_post_to_private_accountsuser-errorTu aplicación está en modo de desarrollo y solo puede publicar de forma privada. Por favor, envíala para revisión en TikTok para poder publicar de forma pública.
Solución:
Tu aplicación de TikTok no está aprobada para producción. Envía tu aplicación para el proceso de revisión de TikTok para habilitar las capacidades de publicación pública.
url_ownership_unverifieduser-errorLa propiedad del dominio no está verificada, por favor verifica la propiedad del dominio.
Solución:
Debes verificar la propiedad de cualquier URL externa en tus publicaciones. Añade el código de verificación a tu dominio o utiliza la consola de desarrolladores de TikTok para verificar.
privacy_level_option_mismatchuser-errorDesajuste en el nivel de privacidad, por favor revisa la configuración de privacidad.
Solución:
El nivel de privacidad que has especificado no coincide con las capacidades de tu aplicación ni con la configuración de tu cuenta. Revisa los permisos de tu aplicación y la configuración de privacidad.
#Server
internalretryThere is a problem with TikTok servers, please try again later.
Solución:
TikTok is experiencing server issues. This is temporary. Wait a few minutes and try again. The system will automatically retry.
invalid_paramsuser-errorInvalid request parameters, please check content format.
Solución:
One or more parameters in your request are invalid. Review the TikTok API documentation and ensure all required fields are present and correctly formatted.
Mejores Prácticas
Manejo de Errores
- →Implementar estrategias de evitación de detección de spam
- →Validar formato y especificaciones de video antes de cargar
- →Manejar límites de tasa con retroceso exponencial
- →Enviar app para aprobación de producción
Consejos de Prevención
- →Usar formato MP4/WebM, mínimo 720p, 23-60 fps
- →Mantener videos de 3 segundos a 10 minutos
- →Evitar contenido repetitivo o promocional
- →Verificar propiedad del dominio para URLs externas
Necesitas Ayuda con TikTok Integración?
Nuestra API maneja escenarios de error automáticamente con lógica de reintento inteligente y registro detallado.