TikTok-fout 40102: het access token is verlopen
TikTok-fout 40102 betekent dat het access token dat bij het verzoek wordt meegestuurd is verlopen, en het endpoint moet opnieuw worden aangeroepen met het meest recente token. Een access token van de Accounts API is één dag geldig. Vernieuw het door het refresh token naar /tt_user/oauth2/refresh_token/ te sturen en herhaal daarna de aanroep. Het refresh token zelf is één jaar geldig; daarna moet de accounteigenaar de app opnieuw autoriseren.
easyCoexistence vernieuwt het 24-uurs TikTok-token zelfstandig met het refresh token, vóór het verloopt, zodat aanroepen vanuit Claude, ChatGPT of je eigen code met een actueel token gaan.
De retourcode van TikTok voor een verlopen access token; het endpoint moet met het meest recente token worden aangeroepen.
Hoe lang een TikTok-accounttoken van de Accounts API geldig blijft.
De waarde expires_in, in seconden, in het voorbeeld van TikTok van een nieuw uitgegeven access token.
Hoe lang het refresh token geldig blijft; na afloop moet de eigenaar de app opnieuw autoriseren.
Wat betekent fout 40102?
Het access token in de Access-Token-header is over de vervaldatum heen. De bijlage met retourcodes van TikTok vermeldt 40102 als een verlopen access token en zegt dat het endpoint met het meest recente token moet worden aangeroepen. De oplossing is een geldig access token gebruiken en de aanroep opnieuw proberen.
De code komt in de body van het antwoord terecht. De meeste aanroepen van de API for Business van TikTok geven HTTP 200 terug, en de retourcode, niet de status, bepaalt of de aanroep is gelukt.
Hoe lang is een TikTok access token geldig?
Één dag op de API for Business. De Accounts API geeft een TikTok-accounttoken af wanneer de app een autorisatiecode inwisselt bij /tt_user/oauth2/token/, en het antwoord geeft de levensduur in expires_in: 86.400 seconden in het voorbeeld van TikTok. Hetzelfde antwoord bevat een refresh token, één jaar geldig, dat TikTok adviseert te bewaren om het access token te vernieuwen. User access tokens van TikTok for Developers, die de Content Posting API gebruikt, zijn in plaats daarvan 2 uur geldig.
Hoe vernieuw je het?
Stuur het refresh token naar /tt_user/oauth2/refresh_token/ met de ID en het secret van de app en grant_type ingesteld op refresh_token. Het antwoord bevat een nieuw access token en een nieuw refresh token: bewaar beide, stuur daarna het nieuwe access token in de Access-Token-header en herhaal de mislukte aanroep. Vernieuwen voordat de dag om is, voorkomt dat aanroepen met een verlopen token TikTok bereiken.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/refresh_token/' \
-H 'Content-Type: application/json' \
-d '{
"client_id": "<APP_ID>",
"client_secret": "<SECRET>",
"grant_type": "refresh_token",
"refresh_token": "<REFRESH_TOKEN>"
}'
# data: access_token, expires_in (86400), refresh_token, refresh_token_expires_inWanneer moet de eigenaar opnieuw autoriseren?
Wanneer vernieuwen niet meer kan. Het refresh token is één jaar geldig, en de documentatie van TikTok zegt dat de ontwikkelaar, na afloop, de accounteigenaar vraagt de app opnieuw te autoriseren via de autorisatieflow. De eigenaar kan de autorisatie ook op elk moment intrekken in de TikTok-app, onder Instellingen en privacy, Beveiliging, App-machtigingen beheren; een nieuwe autorisatie is dan de weg terug.
Veelgemaakte fouten
- Pas vernieuwen nadat een aanroep is mislukt. Een token dat één dag geldig is, verloopt elke dag, dus vernieuw het van tevoren en voorkom dat aanroepen TikTok bereiken met een oud token.
- De refresh token in het vernieuwingsantwoord negeren. De referentie van TikTok zegt het voor de volgende vernieuwing te bewaren, dus sla bij elke vernieuwing het teruggegeven exemplaar op.
- Alleen de HTTP-status controleren. TikTok antwoordt meestal met HTTP 200 en zet 40102 in het codeveld, dus een statuscontrole alleen leest de fout als succes.
- Kopieën van het token op meerdere plekken bewaren. Als je één kopie vernieuwt, lopen de andere tot het eind van hun dag en mislukken ze met 40102.
Als TikTok het token toch afwijst met 40102, 40104 of 40105, wordt de verbinding meteen gemarkeerd om opnieuw te verbinden en krijg je een e-mail. Je eigen code kan het actuele token ophalen via get_social_credentials in plaats van een kopie te bewaren. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Wat betekent expires_in in een TikTok-tokenantwoord?
Het is het aantal seconden voordat het access token verloopt: 86.400, één dag, in het voorbeeld van TikTok van een nieuw Accounts API-token. Tel dat op bij het tijdstip van het antwoord om te weten wanneer je moet vernieuwen, vóór 40102.
Kan een verlopen TikTok access token worden vernieuwd?
Ja, zolang het refresh token geldig is. Stuur het naar /tt_user/oauth2/refresh_token/, en TikTok geeft een nieuw access token terug met een refresh token.
Betekent fout 40102 dat het account opnieuw verbonden moet worden?
Op zichzelf niet. Een geldig refresh token vernieuwt de toegang zonder de eigenaar; een nieuwe autorisatie is alleen nodig wanneer het refresh token is verlopen of de eigenaar de toegang heeft ingetrokken.
Waarom bevat een antwoord met HTTP 200 toch fout 40102?
De retourcodes van TikTok gaan voor op de HTTP-status. Een aanroep is alleen geslaagd als de code 0 is, wat de statusregel ook zegt.
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