TikTok-fout 40103: refresh token verlopen
TikTok-fout 40103 betekent dat de refresh token is verlopen, waardoor het access token van het account niet langer kan worden vernieuwd. Een refresh token van de Accounts API is één jaar geldig. De oplossing van TikTok is een nieuwe autorisatie: de eigenaar van het account doorloopt de autorisatieflow van de app opnieuw. Daarmee krijg je een nieuw access token en een nieuwe refresh token, die het oude paar vervangen.
easyCoexistence slaat het refresh token en de vervaldatum op uit elke TikTok-vernieuwing en vernieuwt het access token van 24 uur zelfstandig, voor Claude, ChatGPT of je eigen code.
De retourcode van TikTok voor een verlopen refresh token; de oplossing is dat de gebruiker de app opnieuw autoriseert.
Hoelang een refresh token van de Accounts API geldig blijft.
Seconden in refresh_token_expires_in, precies één jaar, in het voorbeeld van TikTok voor nieuw uitgegeven tokens.
Hoelang de autorisatiecode van een nieuwe autorisatie geldig blijft, voor één keer gebruik.
Wat betekent fout 40103?
Het refresh token dat is verstuurd om het access token te vernieuwen, is over de vervaldatum heen. In de bijlage met retourcodes van TikTok staat 40103 als verlopen refresh token. De oplossing is een geldig refresh token gebruiken, en om dat te krijgen vraag je de gebruiker de app opnieuw te autoriseren via de autorisatieworkflow voor gebruikers. Totdat dat gebeurt, kan het access token niet worden vernieuwd, en werken aanroepen niet meer zodra het huidige access token het einde van zijn dag bereikt.
Hoelang blijft een refresh token geldig?
Één jaar. Het antwoord van /tt_user/oauth2/token/ bevat refresh_token_expires_in, het aantal seconden tot het refresh token verloopt: 31,536,000 in het voorbeeld van TikTok, precies een jaar. Ook vernieuwingsantwoorden bevatten dit veld, en het vernieuwingsvoorbeeld van TikTok toont 28,484,364 seconden, dus minder dan een jaar. Lees de waarde daarom uit elk antwoord en ga er niet van uit dat elke vernieuwing een nieuw jaar start.
Hoe los je het op?
Vraag de accounteigenaar de app opnieuw te autoriseren. Deel de autorisatie-URL voor de accounthouder van TikTok; zodra die goedkeurt, stuurt TikTok door naar de redirect-URL van de app met een nieuwe auth_code, geldig 10 minuten en eenmaal bruikbaar. Wissel die in bij /tt_user/oauth2/token/ voor een nieuw access token en een nieuw refresh token, en vervang het opgeslagen paar. Heeft de eigenaar dezelfde rechten eerder goedgekeurd, dan slaat TikTok standaard het beoordelingsscherm over en stuurt hem direct terug.
Hoe verschilt 40103 van 40107 en 40131?
De bijlage heeft drie codes voor een mislukte vernieuwing, en ze wijzen op verschillende controles:
- 40103: het refresh token is verlopen. Alleen een nieuwe autorisatie vervangt het.
- 40107: het refresh token is ongeldig of onjuist, bijvoorbeeld een token dat is gebruikt om een Marketing API-token te vernieuwen, en dat nooit verloopt.
- 40131: een authenticatiefout bij /
tt_user/oauth2/token/ of /tt_user/oauth2/refresh_token/, door een verkeerde app-ID of geheim, een verlopen autorisatiecode, of een ongeldig of verlopen refresh token.
Veelgemaakte fouten
- Wachten tot 40103 optreedt om de volgende autorisatie te plannen. refresh_token_expires_in geeft de datum vooraf, zodat de eigenaar kan worden gevraagd voordat de vernieuwing stopt.
- Aannemen dat elke vernieuwing het jaar opnieuw laat beginnen. Het vernieuwingsvoorbeeld van TikTok geeft in refresh_token_expires_in minder dan een jaar terug, dus lees de waarde uit elk antwoord.
- Het refresh token weggooien dat een vernieuwing teruggeeft. De referentie van TikTok zegt dat je het moet bewaren voor de volgende vernieuwing.
Weigert TikTok een vernieuwing, dan geeft de tool de code en melding van TikTok terug, en het account opnieuw verbinden via het dashboard geeft een nieuw paar tokens. Van US$ 9 tot US$ 0.75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Hebben refresh tokens van de Content Posting API ook een geldigheid van een jaar?
Nee. Refresh tokens van TikTok for Developers, gebruikt door de Content Posting API, gelden 180 dagen. De levensduur van één jaar geldt voor refresh tokens van API for Business, waarvan de resterende seconden in refresh_token_expires_in staan.
Kan een verlopen TikTok refresh token worden vernieuwd?
Nee. De oplossing van TikTok voor 40103 is een nieuwe autorisatie door de accounteigenaar, die een nieuw access token en een nieuw refresh token uitgeeft.
Ziet de eigenaar het toestemmingsscherm van TikTok opnieuw?
Niet standaard. Heeft hij dezelfde rechten eerder goedgekeurd, dan slaat TikTok het beoordelingsscherm over en stuurt hem terug naar de app met een nieuwe autorisatiecode.
Wat gebeurt er met aanroepen nadat het refresh token is verlopen?
Ze blijven werken tot het huidige access token het einde van zijn dag bereikt. Daarna mislukken ze met 40102, omdat het token niet meer kan worden vernieuwd.
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