Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Error 40002 de TikTok: error de parámetro en la petición

El error 40002 de TikTok es un error de parámetro: un campo de la petición falta, tiene un formato incorrecto, no se admite o es incompatible con otro campo. El mensaje de la respuesta indica el problema, por ejemplo un campo obligatorio que falta. Corrige ese campo según la referencia del endpoint, como business_id, post_info o max_count en la Accounts API, y vuelve a enviar la petición.

easyCoexistence añade business_id a cada llamada a TikTok que hace para Claude, ChatGPT o tu propio código, y revisa cada publicación antes de enviarla: un video o de 1 a 35 imágenes, con enlaces HTTPS, y rechaza las fotos PNG porque TikTok solo acepta JPEG o WebP.

40002

Código de retorno de TikTok para un error de parámetro, con los detalles en el mensaje de la respuesta.

HTTP 200

Estado HTTP del ejemplo de respuesta 40002 de TikTok: es el campo code, no el estado, el que muestra el fallo.

2,200

Caracteres, contados en UTF-16, que admite la descripción de un video a través de la Accounts API, incluidas hasta 30 menciones.

1 to 30

Comentarios por página que /business/comment/list/ acepta en max_count; el valor predeterminado es 20.

60 days

Días hacia atrás que, como máximo, puede alcanzar un start_date cuando /business/get/ lee las métricas de la cuenta.

¿Qué significa el error 40002?

Uno o más parámetros no se ajustan a lo que acepta el endpoint. El apéndice de códigos de retorno de TikTok incluye el 40002 como error de parámetro y remite al mensaje de error para ver los detalles. Las causas que menciona son campos obligatorios que faltan, un formato incorrecto, campos o valores no admitidos, campos incompatibles entre sí, una precisión de datos no válida y un número no válido.

¿Cómo se interpreta la respuesta?

Empieza por el mensaje, que indica el campo. El propio ejemplo de TikTok, más abajo, responde con HTTP 200 y el mensaje "Missing required field(s): account_id." Otro ejemplo del apéndice dice "Time format should be %Y-%m-%dT%H:%M." Guarda también el request_id, ya que las referencias de TikTok lo piden al informar de un problema.

TikTok's example 40002 response
HTTPS/1.1 200 OK
{
    "code": 40002,
    "message": "Missing required field(s): account_id.",
    "request_id": "2022110918305001025108614416C7CC00"
}

¿Qué reglas de la Accounts API conviene revisar?

La referencia de cada endpoint fija sus propias reglas. Estas son las que rigen las llamadas que hace una conexión para publicar, gestionar comentarios y leer métricas:

  • En todas las llamadas: business_id, con el open_id que se devolvió junto con el token de acceso de la cuenta.
  • Publicaciones de video: video_url y post_info son obligatorios, post_info aunque esté vacío; las descripciones admiten hasta 2200 caracteres.
  • Publicaciones de fotos: hasta 35 URL de imágenes en photo_images, un privacy_level que la cuenta permita y un título de hasta 90 caracteres.
  • Comentarios: video_id es el item_id de una publicación obtenido de /business/video/list/, max_count va de 1 a 30 y comment_ids admite como máximo 30.
  • Respuestas: texto de hasta 1200 caracteres, o una imagen en su lugar.
  • Métricas: fechas con el formato 2021-06-01, en UTC, que no se remonten más de 60 días.

¿Cómo se soluciona?

Busca en la referencia del endpoint el campo que indica el mensaje, corrígelo y vuelve a enviar la petición. El error describe la propia petición, así que enviarla sin cambios devuelve el mismo código. Para los valores que dependen de la cuenta, como los niveles de privacidad o si se pueden activar los comentarios, consulta las opciones permitidas en /business/video/settings/ antes de publicar.

¿Y los problemas con el archivo multimedia?

TikTok informa de ellos después de la llamada. Los endpoints de publicación devuelven un share_id para la tarea de publicación mientras TikTok descarga el archivo y, cuando el archivo incumple una regla, /business/publish/status/ indica FAILED con un motivo como file_format_check_failed, frame_rate_check_failed o picture_size_check_failed. TikTok marca esos motivos como no reintentables, así que hay que cambiar el propio archivo.

Errores comunes

  • Volver a enviar la misma petición. El 40002 describe los parámetros, así que nada cambia hasta que se corrige el campo que indica el mensaje.
  • Escribir los parámetros de tipo array como texto plano. Campos como fields se envían como arrays JSON, como en el ejemplo de TikTok ["display_name", "profile_image"].
  • Usar la misma configuración de privacidad para todas las cuentas. Las opciones difieren entre cuentas públicas y privadas, así que consulta primero privacy_level_options en /business/video/settings/.
  • Poner disable_comment en false en una cuenta con los comentarios desactivados. Cuando comment_disabled es true, TikTok solo acepta true.
Hacerlo con EasyCoexistence

Si TikTok aun así responde 40002, la herramienta devuelve su código y su mensaje para que tu IA corrija el campo y vuelva a intentarlo. De US$ 9 a US$ 0.75 por conexión al mes, un precio que baja a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Qué es un error de parámetro en la API de TikTok?

Es el código de retorno 40002: un campo de la petición falta, tiene un formato incorrecto, no se admite o es incompatible con otro campo, y el mensaje indica cuál.

¿Por qué TikTok devuelve el error 40002 con HTTP 200?

Los códigos de retorno de TikTok prevalecen sobre el estado HTTP, así que una respuesta 200 cuyo código no es 0 sigue siendo una llamada fallida.

¿Debo reintentar la petición tras el error 40002?

Solo después de cambiarla. El error lo causan los parámetros, así que corrige el campo que indica el mensaje antes de volver a enviarla.

¿Dónde aparecen los problemas con el archivo de video?

En el estado de publicación. Una vez que TikTok descarga el archivo multimedia, si incumple sus reglas, /business/publish/status/ indica FAILED, con un motivo que nombra la comprobación fallida.

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