Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Erreur TikTok 40002 : paramètre incorrect dans la requête

L'erreur TikTok 40002 est une erreur de paramètre : un champ de la requête est absent, a un format incorrect, n'est pas pris en charge ou est incompatible avec un autre champ. Le message de la réponse nomme le problème, par exemple un champ obligatoire absent. Corrigez ce champ selon la référence de l'endpoint, par exemple business_id, post_info ou max_count dans l'Accounts API, puis renvoyez la requête.

easyCoexistence ajoute business_id à chaque appel TikTok qu'il effectue pour Claude, ChatGPT ou votre propre code, et vérifie une publication avant l'envoi : une vidéo ou de 1 à 35 images, sur des liens HTTPS, les photos PNG étant refusées car TikTok n'accepte que le JPEG ou le WebP.

40002

Le code de retour de TikTok pour une erreur de paramètre, avec le détail dans le message de la réponse.

HTTP 200

Le statut de l'exemple de réponse 40002 de TikTok : c'est le champ code, et non le statut, qui signale l'échec.

2,200

Caractères, comptés en UTF-16, qu'une légende vidéo peut contenir via l'Accounts API, y compris jusqu'à 30 mentions.

1 to 30

Commentaires par page que /business/comment/list/ accepte dans max_count : la valeur par défaut est 20.

60 days

La date la plus ancienne que start_date peut atteindre lorsque /business/get/ lit les statistiques du compte.

Que signifie l'erreur 40002 ?

Un ou plusieurs paramètres ne correspondent pas à ce que l'endpoint accepte. L'annexe des codes de retour de TikTok classe 40002 comme erreur de paramètre et renvoie au message d'erreur pour le détail. Les causes citées sont : champs obligatoires absents, format incorrect, champs ou valeurs non pris en charge, champs incompatibles entre eux, précision des données invalide et numéro invalide.

Comment lire la réponse ?

Commencez par le message, qui nomme le champ. L'exemple de TikTok, ci-dessous, revient avec le code HTTP 200 et le message « Missing required field(s): account_id. » Un autre exemple de l'annexe indique « Time format should be %Y-%m-%dT%H:%M. » Conservez aussi le request_id, car les références de TikTok le demandent dans les signalements de problème.

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

Quelles règles de l'Accounts API valent la peine d'être vérifiées ?

La référence de chaque endpoint fixe ses propres règles. Voici celles qui s'appliquent aux appels d'une connexion pour publier, gérer les commentaires et lire les statistiques :

  • Chaque appel : business_id, égal à l'open_id renvoyé avec le token d'accès du compte.
  • Publications vidéo : video_url et post_info sont tous deux obligatoires, post_info même lorsqu'il est vide ; les légendes sont limitées à 2 200 caractères.
  • Publications photo : jusqu'à 35 URL d'images dans photo_images, un privacy_level autorisé pour le compte, et un titre de 90 caractères au maximum.
  • Commentaires : video_id correspond à l'item_id d'une publication issu de /business/video/list/, max_count va de 1 à 30, et comment_ids en accepte 30 au maximum.
  • Réponses : texte de 1 200 caractères au maximum, ou une image à la place.
  • Statistiques : dates au format 2021-06-01, en UTC, remontant au plus à 60 jours.

Comment corriger ?

Repérez le champ nommé par le message dans la référence de l'endpoint, corrigez-le et renvoyez la requête. L'erreur décrit la requête elle-même : la renvoyer sans modification donne donc le même code. Pour les valeurs qui dépendent du compte, comme les niveaux de confidentialité ou l'activation des commentaires, lisez les options autorisées dans /business/video/settings/ avant de publier.

Et les problèmes du fichier média ?

TikTok les signale après l'appel. Les endpoints de publication renvoient un share_id pour la tâche de publication pendant que TikTok télécharge le fichier. Si le fichier ne respecte pas une règle, /business/publish/status/ affiche FAILED avec une raison telle que file_format_check_failed, frame_rate_check_failed ou picture_size_check_failed. TikTok marque ces raisons comme non réessayables : c'est donc le fichier lui-même qui doit changer.

Erreurs courantes

  • Renvoyer la même requête. 40002 décrit les paramètres : rien ne change tant que le champ nommé par le message n'est pas corrigé.
  • Écrire les paramètres de type tableau en texte brut. Des champs comme fields s'envoient sous forme de tableaux JSON, comme dans l'exemple de TikTok ["display_name", "profile_image"].
  • Utiliser le même réglage de confidentialité pour tous les comptes. Les options diffèrent entre comptes publics et privés : lisez d'abord privacy_level_options dans /business/video/settings/.
  • Mettre disable_comment à false sur un compte dont les commentaires sont désactivés. Lorsque comment_disabled vaut true, TikTok n'accepte que true.
Faire cela avec EasyCoexistence

Si TikTok répond encore 40002, l'outil renvoie son code et son message, pour que votre IA corrige le champ et réessaie. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec 3 jours d'essai gratuit.

Questions fréquemment posées

Qu'est-ce qu'une erreur de paramètre dans l'API TikTok ?

C'est le code de retour 40002 : un champ de la requête est absent, mal formé, non pris en charge ou incompatible avec un autre champ, et le message indique lequel.

Pourquoi TikTok renvoie-t-il l'erreur 40002 avec HTTP 200 ?

Les codes de retour de TikTok priment sur le statut HTTP : une réponse 200 dont le code n'est pas 0 reste un appel échoué.

Faut-il relancer une erreur 40002 ?

Seulement après avoir modifié la requête. Ce sont les paramètres qui provoquent l'erreur : corrigez le champ nommé dans le message avant de la renvoyer.

Où apparaissent les problèmes du fichier vidéo ?

Dans le statut de publication. Une fois le média téléchargé par TikTok, un fichier qui enfreint ses règles fait passer /business/publish/status/ à FAILED, avec une raison qui nomme le contrôle échoué.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le