Error 40104 de TikTok: el token de acceso está vacío
El error 40104 de TikTok significa que la petición llegó sin token de acceso. Los endpoints de la Accounts API, como /business/video/list/ y /business/comment/list/, esperan el token de la cuenta de TikTok en un encabezado llamado Access-Token. Agrega ese encabezado con un token válido, obtenido de /tt_user/oauth2/token/ o renovado con el token de actualización, y vuelve a enviar la petición.
easyCoexistence agrega el token actual de la cuenta de TikTok, en el encabezado Access-Token, a cada llamada que hace para Claude, ChatGPT o tu propio código.
Código de retorno de TikTok cuando el token de acceso está vacío; la solución es enviar uno válido.
El encabezado obligatorio que lleva el token de la cuenta de TikTok en los endpoints de la Accounts API.
El parámetro que identifica la cuenta de TikTok en cada llamada, con el valor open_id devuelto junto con su token.
El token_type que devuelve TikTok con el token de acceso de una cuenta de TikTok, que igualmente se envía en Access-Token.
¿Qué significa el error 40104?
TikTok recibió la llamada sin token de acceso. El apéndice de códigos de retorno lista 40104 como token de acceso vacío, con la misma solución que los demás errores de token: usar un token de acceso válido y volver a intentarlo. La petición llegó a TikTok, pero nada en ella indicaba bajo qué autorización actúa, así que TikTok la trata como fallida.
¿Dónde va el token?
En un encabezado llamado Access-Token. Las referencias de la Accounts API, desde la publicación hasta los comentarios y las métricas, indican Access-Token como encabezado obligatorio con el token que autorizó la cuenta de TikTok. La cuenta en sí se indica por separado, en business_id, con el valor open_id que llegó junto con el token.
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["item_id","caption","video_views"]'¿Cómo queda vacío el encabezado?
El token se pierde entre el almacenamiento y la petición. Estos son los lugares donde revisar:
- El encabezado tiene otro nombre. Un token enviado como Authorization: Bearer deja Access-Token vacío, aunque TikTok indique que el tipo del token es Bearer.
- La variable que guarda el token está vacía, por ejemplo después de una renovación que falló sin que se revisara su error.
- El token viaja en el cuerpo o en la cadena de consulta en lugar del encabezado.
- Se reutiliza un helper escrito para /
tt_user/oauth2/token/ y /tt_user/oauth2/refresh_token/; esos endpoints no reciben el encabezado Access-Token, así que el helper no envía ninguno.
¿Cómo se soluciona?
Envía el token en Access-Token, junto con business_id. Si no hay un token vigente que enviar, obtén uno: renueva con /tt_user/oauth2/refresh_token/ mientras el token de actualización sea válido, o pide al titular de la cuenta que vuelva a autorizar la aplicación si no lo es. Al depurar, registra si el encabezado está presente y cuánto mide su valor, no el token en sí, ya que TikTok advierte que cualquiera que tenga el token puede usarlo.
Errores comunes
- Tratar el 40104 como un token vencido. El token está ausente, no viejo, así que renovarlo no cambia nada hasta que el código realmente lo envíe.
- Renovar el token sin pasar el nuevo. La renovación devuelve un nuevo token de acceso, y las llamadas siguientes deben enviar ese valor en Access-Token.
- Reintentar la petición sin cambios. Sin el encabezado, cada intento llega a TikTok de la misma forma y recibe el mismo código.
Si TikTok responde igual con 40102, 40104 o 40105, la conexión se marca de inmediato para reconectar y recibes un correo. De US$ 9 a US$ 0.75 por conexión al mes, bajando conforme agregas conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Puedo enviar un token de acceso de TikTok como Authorization: Bearer?
No. Los endpoints de la Accounts API leen el token del encabezado Access-Token, así que un token enviado como Authorization: Bearer lo deja vacío y la llamada devuelve 40104, aunque TikTok indique que el tipo del token es Bearer.
¿40104 es lo mismo que un token vencido?
No. 40104 significa que no llegó ningún token; uno vencido devuelve 40102, y uno inválido o incorrecto devuelve 40105.
¿Los endpoints de token de TikTok necesitan Access-Token?
No. /tt_user/oauth2/token/ y /tt_user/oauth2/refresh_token/ identifican la aplicación con client_id y client_secret en el cuerpo de la petición.
¿business_id reemplaza al token?
No. business_id indica a qué cuenta de TikTok se refiere la llamada, y Access-Token lleva la autorización para actuar en su nombre. Cada llamada necesita ambos.
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