InloggenGratis proefperiode starten
easyCoexistence Officiële API's

TikTok-fout 40002: parameterfout in het verzoek

TikTok-foutcode 40002 is een parameterfout: een veld in het verzoek ontbreekt, heeft een verkeerd formaat, wordt niet ondersteund of past niet bij een ander veld. Het bericht in het antwoord noemt het probleem, bijvoorbeeld een verplicht veld dat ontbreekt. Corrigeer dat veld aan de hand van de referentie van het endpoint, zoals business_id, post_info of max_count bij de Accounts API, en verstuur het verzoek opnieuw.

easyCoexistence voegt business_id toe aan elke TikTok-aanroep die het doet voor Claude, ChatGPT of je eigen code, en controleert een post voordat die wordt verstuurd: een video of 1 tot 35 afbeeldingen, via HTTPS-links, waarbij PNG-foto's worden geweigerd omdat TikTok alleen JPEG of WebP accepteert.

40002

De retourcode van TikTok voor een parameterfout, met de details in het bericht van het antwoord.

HTTP 200

De status van TikTok's voorbeeldantwoord bij 40002: het code-veld, niet de status, toont de fout.

2,200

Tekens, geteld in UTF-16, die een video-bijschrift via de Accounts API kan bevatten, inclusief tot 30 vermeldingen.

1 to 30

Reacties per pagina die /business/comment/list/ accepteert in max_count; de standaard is 20.

60 days

Hoe ver terug een start_date kan reiken wanneer /business/get/ inzichten van een account leest.

Wat betekent fout 40002?

Een of meer parameters passen niet bij wat het endpoint accepteert. De bijlage met retourcodes van TikTok vermeldt 40002 als parameterfout en verwijst voor details naar het foutbericht. De genoemde oorzaken zijn: verplichte velden die ontbreken, een onjuist formaat, niet-ondersteunde velden of waarden, velden die niet met elkaar combineren, ongeldige nauwkeurigheid van gegevens en een ongeldig nummer.

Hoe lees je het antwoord?

Begin met het bericht, dat het veld noemt. Het eigen voorbeeld van TikTok hieronder komt terug met HTTP 200 en het bericht "Missing required field(s): account_id." Een ander voorbeeld in de bijlage luidt "Time format should be %Y-%m-%dT%H:%M." Bewaar ook de request_id, want de referenties van TikTok vragen daar om bij probleemmeldingen.

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

Welke regels van de Accounts API zijn het controleren waard?

De referentie van elk endpoint stelt zijn eigen regels. Dit zijn de regels achter de aanroepen die een verbinding doet om te publiceren, met reacties te werken en inzichten te lezen:

  • Elke aanroep: business_id, ingesteld op de open_id die terugkwam bij het toegangstoken van het account.
  • Videoposts: video_url en post_info zijn beide verplicht, post_info ook als die leeg is; bijschriften bevatten tot 2.200 tekens.
  • Fotoposts: tot 35 afbeeldings-URL's in photo_images, een privacy_level dat het account toestaat, en een titel van maximaal 90 tekens.
  • Reacties: video_id is het item_id van een post uit /business/video/list/, max_count loopt van 1 tot 30, en comment_ids accepteert maximaal 30.
  • Antwoorden op reacties: tekst van maximaal 1.200 tekens, of een afbeelding in de plaats daarvan.
  • Inzichten: datums zoals 2021-06-01, in UTC, die tot maximaal 60 dagen terugreiken.

Hoe los je het op?

Zoek het veld dat het bericht noemt in de referentie van het endpoint, corrigeer het en verstuur het verzoek opnieuw. De fout beschrijft het verzoek zelf, dus het ongewijzigd opnieuw sturen geeft dezelfde code terug. Voor waarden die van het account afhangen, zoals privacyniveaus of of reacties kunnen worden ingeschakeld, lees je de toegestane opties uit /business/video/settings/ voordat je publiceert.

Hoe zit het met problemen in het mediabestand?

TikTok meldt die na de aanroep. De publicatie-endpoints geven een share_id voor de publicatietaak terug terwijl TikTok het bestand downloadt. Breekt het bestand een regel, dan staat /business/publish/status/ op FAILED met een reden zoals file_format_check_failed, frame_rate_check_failed of picture_size_check_failed. TikTok markeert die redenen als niet opnieuw te proberen, dus het bestand zelf moet veranderen.

Veelgemaakte fouten

  • Hetzelfde verzoek opnieuw sturen. 40002 beschrijft de parameters, dus er verandert niets zolang het veld uit het bericht niet is gecorrigeerd.
  • Arrayparameters als platte tekst schrijven. Velden zoals fields worden als JSON-arrays verstuurd, zoals in het voorbeeld van TikTok ["display_name", "profile_image"].
  • Eén privacy-instelling voor elk account gebruiken. De opties verschillen tussen openbare en privé-accounts, dus lees eerst privacy_level_options uit /business/video/settings/.
  • disable_comment op false zetten bij een account waarvan reacties zijn uitgeschakeld. Staat comment_disabled op true, dan accepteert TikTok alleen true.
Dit doen met EasyCoexistence

Geeft TikTok nog steeds 40002, dan geeft de tool de code en het bericht terug, zodat je AI het veld kan corrigeren en het opnieuw kan proberen. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen als gratis proefperiode.

Veelgestelde vragen

Wat is een parameterfout in de TikTok API?

Het is retourcode 40002: een veld in het verzoek ontbreekt, is onjuist opgemaakt, wordt niet ondersteund of past niet bij een ander veld, en het bericht zegt welk veld het is.

Waarom stuurt TikTok fout 40002 met HTTP 200?

De retourcodes van TikTok gaan voor op de HTTP-status, dus een antwoord met 200 waarvan de code niet 0 is, is nog steeds een mislukte aanroep.

Moet ik fout 40002 opnieuw proberen?

Alleen nadat je het verzoek hebt gewijzigd. De parameters veroorzaken de fout, dus corrigeer het veld dat het bericht noemt voordat je het opnieuw verstuurt.

Waar zie je problemen met het videobestand?

In de status van de publicatie. Zodra TikTok de media heeft gedownload, zorgt een bestand dat de regels breekt ervoor dat /business/publish/status/ op FAILED staat, met een reden die de mislukte controle noemt.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op