Waarom een TikTok API-verbinding stopt en hoe je die actief houdt
Een TikTok API for Business-verbinding werkt niet meer wanneer het access-token van 24 uur niet wordt vernieuwd, het refresh-token van een jaar afloopt, de eigenaar de toegang van de app verwijdert, of het meegestuurde token ontbreekt of fout is. TikTok meldt de tokenproblemen als 40102, 40103, 40104 en 40105. Vroeg vernieuwen, elk account volgens een schema controleren en de eigenaar vragen opnieuw te autoriseren voordat het jaar voorbij is, houdt de verbinding in stand.
easyCoexistence houdt elke TikTok-verbinding zelfstandig in stand: het vernieuwt het token van 24 uur op tijd, controleert het account ongeveer elke 6 uur, en wanneer TikTok het token weigert, zet het kanaal op Opnieuw verbinden nodig en mailt het jou, voor Claude, ChatGPT of je eigen platform.
Levensduur van een access-token voor een TikTok-account via de API for Business; /tt_user/oauth2/refresh_token/ vernieuwt het.
Levensduur van het refresh-token; zodra het verloopt, moet de accounteigenaar de app opnieuw autoriseren.
Foutreden wanneer de eigenaar de toegang van de app verwijdert terwijl TikTok een post verwerkt; TikTok zegt dat je niet opnieuw moet proberen.
Gebeurtenissen die TikTok voor een account niet meer verstuurt zodra de autorisatie van de eigenaar verloopt of wordt ingetrokken.
Waarom authorization.removed van TikTok for Developers wordt afgevuurd: de gebruiker verbreekt de koppeling, het account wordt verwijderd, de leeftijd verandert, er is een ban, of de developer trekt de toegang in.
Hoe vaak easyCoexistence elk verbonden TikTok-account controleert; het vernieuwt het token van 24 uur zelf en mailt je als opnieuw verbinden nodig is.
Waarom stopt een TikTok API-verbinding met werken?
Om een handvol redenen, meestal gekoppeld aan de tokens van het account of aan de toestemming van de eigenaar. Sommige verbreken de verbinding volledig, andere laten haar half werken, met enkele geweigerde aanroepen en de rest die nog antwoordt:
Welke fout geeft elke oorzaak terug, en wat lost die op?
Het code-veld van TikTok benoemt de meeste, binnen een HTTP 200-antwoord in plaats van een foutstatus, en de publicatiestatus voegt er een eigen foutreden aan toe. 40100 staat in de tabel omdat een gedrosselde aanroep op een verloren verbinding kan lijken. Wat elke code betekent, en de oplossing:
| What it means | The fix | |
|---|---|---|
| 40102 | The access token is past its 24 hours | Renew with the refresh token, store both new tokens, repeat the call |
| 40103 | The refresh token has expired | A new authorization by the owner; nothing renews it |
| 40104 | The request carried no access token | A bug in the request: send the Access-Token header |
| 40105 | The access token is invalid or incorrect | Check what was sent, renew, then ask the owner to authorize again |
| 40107 | The refresh token is invalid or incorrect | Send the refresh token from the latest response, or a new authorization |
| 40131 | Authentication failed at a token endpoint | Check the app ID and secret, then the code or the refresh token |
| 40001 | A permission or scope is missing | Add it to the app, then have the owner authorize again |
| auth_removed | Access was removed while a post was processing | No retry; publish again after a new authorization |
| 40100 | Throttled, not disconnected | Pause the endpoint 5 minutes; the token still works |
Hoe lang leven de tokens, en wanneer moet je vernieuwen?
Bij de API for Business geldt een access-token van 24 uur, en expires_in in elk tokenantwoord geeft de resterende seconden; het refresh-token geldt een jaar, met een eigen aftelling in refresh_token_expires_in. Vernieuw ruim voordat de dag voorbij is, volgens een schema en niet pas na een mislukte aanroep, en sla het refresh-token op dat elke vernieuwing teruggeeft, want TikTok's toelichting bij dat veld is het te bewaren. Behandel refresh_token_expires_in als een deadline: in het vernieuwingsvoorbeeld van TikTok telt het af in plaats van een nieuw jaar te starten.
Wat gebeurt er als de eigenaar de toegang van de app verwijdert?
De app verliest de Accounts API-rechten die de eigenaar heeft verleend, dus aanroepen met dat token stoppen met werken, en TikTok documenteert geen API for Business-gebeurtenis die dat aankondigt. De eigenaar kan het op elk moment doen in de TikTok-app, onder Instellingen en privacy, Beveiliging, Appmachtigingen beheren, Toegang verwijderen. De signalen verschijnen elders: een post die TikTok verwerkte, mislukt met auth_removed, waarbij TikTok zegt niet opnieuw te proberen, en comment.update-gebeurtenissen voor het account komen niet meer binnen.
Wat doet een wijziging van accounttype met de verbinding?
TikTok koppelt er in de documentatie geen tokenfout aan; wat verandert is wat de API teruggeeft. Gegevens als unique_video_views, daily_new_followers en audience_activity vereisen Advanced Access of een Verified Business Account, net als de Mentions- en Business Messaging-API's, en de privacy_level_options van een privéaccount laten PUBLIC_TO_EVERYONE weg. Sinds 16 oktober 2026 geeft is_business_account alleen true voor Verified Business Accounts en meldt has_advanced_access de Advanced Access; als je beide onder user.account.type leest, zie je een wijziging voordat een aanroep erop struikelt.
Hoe zie je een dode verbinding voordat een klant dat doet?
Met controles die doorlopen, of er nu iemand post of niet:
- Een lichte aanroep per account volgens een schema, zoals /business/get/ met het veld username, die een tokenfout teruggeeft zodra het token ophoudt te werken.
- /
tt_user/token_info/get/, die geen recht nodig heeft en de scope van het token teruggeeft, om te bevestigen dat de toekenningen nog dekken wat je functies aanroepen. refresh_token_expires_inomzetten in een datum zodra elk antwoord binnenkomt, met een herinnering aan de eigenaar enkele weken ervoor.- Stilte op comment.update voor een account dat normaal reacties krijgt, want TikTok stopt die gebeurtenissen zodra de autorisatie verloopt of wordt ingetrokken.
- 40102, 40103, 40104 en 40105 per account geteld, zodat één falend account opvalt tussen veel andere.
Hoe verbind je een account opnieuw?
Door de autorisatie opnieuw uit te voeren voor hetzelfde account. Deel de autorisatie-URL van de TikTok-accounthouder, met een state-waarde die de terugkeer aan het account koppelt, en disable_auto_auth=1 als de eigenaar de rechtenpagina opnieuw moet zien. Wissel de nieuwe auth_code om bij /tt_user/oauth2/token/ binnen de 10 minuten, en vervang daarna beide opgeslagen tokens. open_id is de applicatiespecifieke ID van TikTok voor het account, dus koppel de nieuwe tokens aan het opgeslagen record via die ID in plaats van een tweede record aan te maken.
Verlopen Content Posting API-verbindingen op dezelfde manier?
Nee. TikTok for Developers, dat de Content Posting- en Display-API's aanbiedt, heeft op 2 november 2026 zijn tokenpagina's bijgewerkt: access-tokens van gebruikers verlopen binnen 2 uur en refresh-tokens gelden 180 dagen vanaf de eerste uitgifte. De refresh-tokens roteren, dus elke geslaagde vernieuwing geeft een nieuwe terug en maakt het verzonden token direct ongeldig; als een server een vervangen token blijft gebruiken, mislukken latere vernieuwingen en moet de gebruiker opnieuw autoriseren. Een slecht refresh-token faalt met invalid_grant, een slecht access-token met access_token_invalid en HTTP 401, en het authorization.removed-webhook zegt waarom een gebruiker is vertrokken.
Wat doet easyCoexistence om een TikTok-verbinding in stand te houden?
Het vernieuwt en controleert zelfstandig, en laat je weten wanneer alleen de eigenaar het kan oplossen:
- Vernieuwing: vóór een aanroep als er minder dan 15 minuten over zijn, en tijdens een controle als er minder dan 8 uur over is, waarbij het nieuwe refresh-token en de vervaldatum elke keer worden opgeslagen.
- Eén vernieuwing tegelijk per account, zodat aanroepen die samen binnenkomen die delen.
- De controle: een /business/get/-aanroep voor de gebruikersnaam van het account ongeveer elke 6 uur.
- Een geweigerd token, 40102, 40104 of 40105: het kanaal krijgt de status Opnieuw verbinden nodig, de eigenaar krijgt één e-mail, en een platform ontvangt channel.disconnected, met de melding van TikTok als
disconnected_reason. - Tot die tijd antwoorden tools dat het account opnieuw verbonden moet worden, en een geplande post mislukt als reconnect in plaats van TikTok te bereiken.
- Opnieuw verbinden: Connect TikTok op de pagina van het kanaal, of een nieuwe connect-sessie, meldt opnieuw aan en behoudt dezelfde
account_iden gebeurtenisbestemming.
Zo stel je het in
- Store both tokens with datesSave access_token, refresh_token, open_id and scope, and turn expires_in and refresh_token_expires_in into dates as each response arrives.
- Renew ahead of the dayCall /tt_user/oauth2/refresh_token/ well before the 24 hours end, one renewal per account at a time, and keep the refresh token it returns.
- Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
- Ask before the year endsSend the owner the authorization URL before refresh_token_expires_in runs out, and replace both tokens when the new code arrives.
- Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.
Veelgemaakte fouten
- Een stille comment-webhook als een stil account zien. TikTok stopt comment.update voor een account zodra de autorisatie eindigt, dus controleer het account in plaats van op gebeurtenissen te wachten.
- Opnieuw verbinden in een nieuw record. Koppel de nieuwe tokens via open_id, de applicatiespecifieke ID van TikTok voor het account, en werk het opgeslagen record op zijn plek bij, met behoud van geschiedenis en instellingen.
- 40103 of 40107 opnieuw proberen met hetzelfde refresh-token. Geen van beide verdwijnt bij een nieuwe poging: de eerste vraagt om een nieuwe autorisatie, de tweede het refresh-token uit het laatste antwoord of een nieuwe autorisatie.
- 40100 lezen als een verloren verbinding. Het is een gedrosselde aanroep; pauzeer het endpoint 5 minuten, of tot 00:00 UTC na een daglimiet, en hetzelfde token blijft werken.
US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Kan een TikTok API-verbinding zonder de eigenaar eeuwig blijven bestaan?
Nee. Vernieuwing houdt haar hooguit door het jaar van het refresh-token heen; daarna is het documentatiepad van TikTok een nieuwe autorisatie door de accounteigenaar.
Waarom zijn TikTok-verbindingen bij meerdere accounts tegelijk mislukt?
Kijk eerst naar de app, voor de accounts: 40113 betekent dat de app is geblokkeerd of dat haar ID en secret niet kloppen, en TikTok kan de toegang van een app tot de Accounts API intrekken bij misbruik.
Betekent een nieuwe functie dat je TikTok-accounts opnieuw moet verbinden?
Als die een scope vereist die de eigenaar nooit heeft verleend, ja. Een token houdt de scopes die bij autorisatie zijn goedgekeurd, dus de eigenaar autoriseert de app opnieuw om er een toe te voegen.
Wat gebeurt er met geplande TikTok-posts terwijl een account opnieuw verbonden moet worden?
Op easyCoexistence mislukken ze op hun tijdstip als reconnect in plaats van TikTok te bereiken, de eigenaar krijgt een e-mail, en Opnieuw proberen verstuurt ze zodra het account weer verbonden is.
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