Error 40131 de TikTok: error de autenticación en los endpoints de token
El error 40131 de TikTok es un error de autenticación que llega desde /tt_user/oauth2/token/ o /tt_user/oauth2/refresh_token/, los endpoints que emiten y renuevan los tokens de cuenta de TikTok. TikTok indica tres causas: un app ID o secreto incorrecto, un código de autorización vencido, o un refresh token inválido o caducado. El endpoint que lo devolvió indica qué dato revisar primero.
easyCoexistence hace ambas llamadas de token por ti: intercambia el código de autorización en cuanto TikTok te devuelve desde su inicio de sesión, y renueva el token de acceso de 24 horas con el refresh token por su cuenta.
Código de retorno de TikTok para un error de autenticación en /tt_user/oauth2/token/ o /tt_user/oauth2/refresh_token/.
Tiempo de validez de un código de autorización de la Accounts API; cada código solo puede usarse una vez.
Tiempo de validez de un refresh token; al vencer, el titular debe volver a autorizar la app.
Error HTTP que el apéndice de TikTok atribuye a llamar a /tt_user/oauth2/refresh_token sin la barra final.
¿Qué significa el error 40131?
Una petición para obtener o renovar un token de cuenta de TikTok falló en la autenticación. El apéndice de códigos de retorno vincula el 40131 a dos endpoints: /tt_user/oauth2/token/, que intercambia un código de autorización por tokens, y /tt_user/oauth2/refresh_token/, que renueva el token de acceso. Su mensaje de ejemplo es "Authorization code is expired." Enumera tres causas comunes:
- El app ID o el secreto es incorrecto.
- El código de autorización venció.
- El refresh token no es válido o venció.
¿Cómo se corrige en /tt_user/oauth2/token/?
Revisa los tres datos que TikTok indica para este endpoint: el app ID, el secreto y el código de autorización. El ID y el secreto están en el portal TikTok API for Business, en My Apps, App Detail, Basic Information. El código dura 10 minutos y funciona una sola vez, así que intercámbialo en cuanto llegue la redirección, y vuelve a iniciar la autorización si es muy antiguo. El redirect_uri enviado con él también debe coincidir con la URL de redirección configurada en la app.
¿Cómo se corrige en /tt_user/oauth2/refresh_token/?
Envía un refresh token válido. Confirma que la petición lleve el refresh token guardado más recientemente para esa cuenta, junto con el app ID y el secreto correctos. Si el refresh token venció o ya no es válido, el apéndice de TikTok indica que el titular vuelva a autorizar la app, lo que emite un nuevo token de acceso y un nuevo refresh token.
¿Qué códigos relacionados indican una sola causa?
El mismo apéndice enumera códigos más específicos para algunos de estos casos, cada uno con su descripción:
- 40103: el refresh token venció y el usuario debe volver a autorizar la app.
- 40107: el refresh token no es válido o es incorrecto.
- 40110: el código de autorización fue cancelado, ya se usó o venció.
- 40113: la app está bloqueada o no existe, y las causas habituales son un app ID o un secreto incorrectos.
Errores comunes
- Quitar la barra final. El apéndice de TikTok indica que /tt_user/oauth2/refresh_token sin la / final puede devolver 404 page not found en lugar de un código de retorno.
- Intercambiar un código de autorización dos veces. Funciona una vez y durante 10 minutos, así que un callback recargado o reintentado no puede volver a usarse.
- Pedir al titular que autorice de nuevo antes de revisar el app ID y el secreto. Si son incorrectos, una nueva autorización falla en el mismo punto.
- Usar credenciales de otra app. El app ID y el secreto deben pertenecer a la app que el titular de la cuenta autorizó.
Si TikTok rechaza una renovación, la herramienta entrega a Claude, ChatGPT o a tu propio código el código y el mensaje de TikTok, y volver a conectar la cuenta desde el panel inicia una nueva autorización. De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Qué endpoints devuelven el error 40131 de TikTok?
/tt_user/oauth2/token/, que convierte un código de autorización en tokens, y /tt_user/oauth2/refresh_token/, que renueva el token de acceso.
¿Dónde están el app ID y el secreto de TikTok?
En el portal TikTok API for Business, en My Apps, luego App Detail y después Basic Information.
¿El 40131 siempre significa que el titular debe reconectar?
No. Un app ID o un secreto incorrectos se corrigen en la configuración de la propia app. Hace falta una nueva autorización cuando el código de autorización o el refresh token han vencido.
¿Cuánto dura un código de autorización de TikTok para la petición de token?
10 minutos, y solo para un intercambio. Después, la guía de TikTok es volver a empezar los pasos de autorización.
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