Error 40103 de TikTok: token de actualización caducado
El error 40103 de TikTok indica que el token de actualización caducó, por lo que ya no puede renovar el token de acceso de la cuenta. Un token de actualización de la Accounts API es válido durante un año. La solución que ofrece TikTok es una nueva autorización: el titular de la cuenta vuelve a pasar por el flujo de autorización de la app, lo que devuelve un nuevo token de acceso y un nuevo token de actualización que deben guardarse en lugar del par anterior.
easyCoexistence guarda el token de actualización y su vencimiento de cada renovación de TikTok y renueva el token de acceso de 24 horas por su cuenta, para Claude, ChatGPT o tu propio código.
Código de retorno de TikTok para un token de actualización caducado; la solución es que el usuario vuelva a autorizar la app.
Cuánto tiempo es válido un token de actualización de la Accounts API.
Segundos en refresh_token_expires_in, exactamente un año, en el ejemplo de TikTok de tokens recién emitidos.
Cuánto tiempo es válido el código de autorización de una nueva autorización, de un solo uso.
¿Qué significa el error 40103?
El token de actualización enviado para renovar el token de acceso ha superado su vencimiento. El apéndice de códigos de retorno de TikTok lista 40103 como token de actualización caducado. Su solución es usar un token de actualización válido y, para obtenerlo, pedir al usuario que vuelva a autorizar la app mediante el flujo de autorización de usuario. Hasta entonces el token de acceso no se puede renovar, y las llamadas dejan de funcionar cuando el token actual llega al final de su día.
¿Cuánto dura un token de actualización?
Un año. La respuesta de /tt_user/oauth2/token/ incluye refresh_token_expires_in, los segundos que quedan hasta que el token de actualización caduca: 31,536,000 en el ejemplo de TikTok, exactamente un año. Las respuestas de renovación traen el mismo campo, y el ejemplo de renovación de TikTok muestra 28,484,364 segundos, menos de un año, así que conviene leer la cifra de cada respuesta en lugar de suponer que cada renovación inicia un año nuevo.
¿Cómo se soluciona?
Pide al titular de la cuenta que vuelva a autorizar la app. Comparte la URL de autorización del titular de la cuenta de TikTok; una vez que la aprueba, TikTok redirige a la URL de redirección de la app con un nuevo auth_code, válido durante 10 minutos y de un solo uso. Intercámbialo en /tt_user/oauth2/token/ por un nuevo token de acceso y un nuevo token de actualización, y reemplaza el par guardado. Si el titular ya aprobó antes los mismos permisos, TikTok omite de forma predeterminada la página de revisión y lo devuelve directamente.
¿En qué se diferencia 40103 de 40107 y 40131?
El apéndice tiene tres códigos para una renovación fallida, y apuntan a comprobaciones distintas:
- 40103: el token de actualización ha caducado. Solo una nueva autorización lo reemplaza.
- 40107: el token de actualización es inválido o incorrecto, por ejemplo uno enviado para renovar un token de la Marketing API, que nunca caduca.
- 40131: un error de autenticación en /
tt_user/oauth2/token/ o /tt_user/oauth2/refresh_token/, por un ID o secreto de app incorrecto, un código de autorización caducado, o un token de actualización inválido o caducado.
Errores comunes
- Esperar a 40103 para planificar la siguiente autorización. refresh_token_expires_in indica la fecha con antelación, así que se puede pedir al titular antes de que la renovación se detenga.
- Suponer que cada renovación reinicia el año. El ejemplo de renovación de TikTok devuelve menos de un año en refresh_token_expires_in, así que lee el valor de cada respuesta.
- Descartar el token de actualización que devuelve una renovación. La referencia de TikTok indica conservarlo para la siguiente renovación.
Si TikTok rechaza una renovación, la herramienta devuelve el código y el mensaje de TikTok, y volver a conectar la cuenta desde el panel emite un nuevo par de tokens. De US$ 9 a US$ 0.75 por conexión al mes, bajando según añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Los tokens de actualización de la Content Posting API también duran un año?
No. Los tokens de actualización de TikTok for Developers, usados por la Content Posting API, duran 180 días; la vida útil de un año corresponde a los tokens de actualización de la API for Business, cuyos segundos restantes aparecen en refresh_token_expires_in.
¿Se puede renovar un token de actualización de TikTok caducado?
No. La solución de TikTok para 40103 es una nueva autorización por parte del titular de la cuenta, que emite un nuevo token de acceso y un nuevo token de actualización.
¿El titular vuelve a ver la página de permisos de TikTok?
No por defecto. Si ya aprobó los mismos permisos antes, TikTok omite la página de revisión y redirige a la app con un nuevo código de autorización.
¿Qué pasa con las llamadas después de que caduca el token de actualización?
Siguen funcionando hasta que el token de acceso actual llega al final de su día. Después fallan con 40102, porque el token ya no se puede renovar.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el