TikTok-Fehler 40103: Refresh-Token abgelaufen
TikTok-Fehler 40103 bedeutet, dass das Refresh-Token abgelaufen ist und daher das Access-Token des Kontos nicht mehr erneuern kann. Ein Refresh-Token der Accounts API ist ein Jahr gültig. Die Lösung, die TikTok vorsieht, ist eine neue Autorisierung: Der Kontoinhaber durchläuft den Autorisierungsablauf der App erneut. Dabei werden ein neues Access-Token und ein neues Refresh-Token ausgestellt, die anstelle des alten Paares gespeichert werden müssen.
easyCoexistence speichert das Refresh-Token und sein Ablaufdatum aus jeder TikTok-Erneuerung und erneuert das Access-Token mit 24 Stunden Laufzeit selbstständig, für Claude, ChatGPT oder Ihren eigenen Code.
Der Rückgabecode von TikTok für ein abgelaufenes Refresh-Token; die Lösung ist, dass der Kontoinhaber die App erneut autorisiert.
Wie lange ein Refresh-Token der Accounts API gültig bleibt.
Sekunden in refresh_token_expires_in, genau ein Jahr, im Beispiel von TikTok für neu ausgestellte Tokens.
Wie lange der Autorisierungscode einer neuen Autorisierung gültig bleibt, und zwar für eine einzige Verwendung.
Was bedeutet Fehler 40103?
Das Refresh-Token, das zur Erneuerung des Access-Tokens gesendet wurde, ist über seinen Ablauf hinaus. Der Anhang mit den Rückgabecodes von TikTok führt 40103 als abgelaufenes Refresh-Token auf. Die Abhilfe besteht darin, ein gültiges Refresh-Token zu verwenden. Dafür bittet man den Kontoinhaber, die App über den Autorisierungsablauf für Nutzer erneut zu autorisieren. Bis dahin lässt sich das Access-Token nicht erneuern, und Aufrufe funktionieren nicht mehr, sobald das aktuelle Token sein Tagesende erreicht.
Wie lange ist ein Refresh-Token gültig?
Ein Jahr. Die Antwort von /tt_user/oauth2/token/ enthält refresh_token_expires_in, die Sekunden bis zum Ablauf des Refresh-Tokens: 31,536,000 im Beispiel von TikTok, genau ein Jahr. Auch Erneuerungsantworten enthalten dieses Feld, und das Erneuerungsbeispiel von TikTok zeigt 28,484,364 Sekunden, also weniger als ein Jahr. Den Wert deshalb aus jeder Antwort auslesen, statt anzunehmen, dass jede Erneuerung ein neues Jahr beginnt.
Wie behebt man den Fehler?
Bitten Sie den Kontoinhaber, die App erneut zu autorisieren. Senden Sie dem Kontoinhaber die TikTok-Autorisierungs-URL; sobald er zustimmt, leitet TikTok auf die Redirect-URL der App mit einem neuen auth_code weiter, der 10 Minuten gültig und nur einmal verwendbar ist. Tauschen Sie ihn unter /tt_user/oauth2/token/ gegen ein neues Access-Token und Refresh-Token ein und ersetzen Sie das gespeicherte Paar. Hat der Kontoinhaber dieselben Berechtigungen bereits früher freigegeben, überspringt TikTok standardmäßig die Prüfseite und schickt ihn direkt zurück.
Worin unterscheidet sich 40103 von 40107 und 40131?
Der Anhang enthält drei Codes für eine fehlgeschlagene Erneuerung, und sie verweisen auf unterschiedliche Prüfungen:
- 40103: Das Refresh-Token ist abgelaufen. Nur eine neue Autorisierung ersetzt es.
- 40107: Das Refresh-Token ist ungültig oder falsch, etwa wenn es zur Erneuerung eines Marketing-API-Tokens gesendet wurde, das nie abläuft.
- 40131: ein Authentifizierungsfehler bei /
tt_user/oauth2/token/ oder /tt_user/oauth2/refresh_token/, ausgelöst durch eine falsche App-ID oder ein falsches Secret, einen abgelaufenen Autorisierungscode oder ein ungültiges oder abgelaufenes Refresh-Token.
Häufige Fehler
- Auf 40103 warten, um die nächste Autorisierung zu planen. refresh_token_expires_in nennt das Datum im Voraus, sodass der Kontoinhaber gefragt werden kann, bevor die Erneuerung endet.
- Annehmen, dass jede Erneuerung das Jahr neu beginnen lässt. Das Erneuerungsbeispiel von TikTok liefert in refresh_token_expires_in weniger als ein Jahr, daher wird der Wert aus jeder Antwort ausgelesen.
- Das von einer Erneuerung zurückgegebene Refresh-Token verwerfen. Die Referenz von TikTok verlangt, es für die nächste Erneuerung aufzubewahren.
Verweigert TikTok eine Erneuerung, gibt das Tool den Code und die Meldung von TikTok zurück; eine erneute Verbindung des Kontos über das Dashboard stellt ein neues Token-Paar aus. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.
Häufig gestellte Fragen
Gelten die Refresh-Tokens der Content Posting API ebenfalls ein Jahr?
Nein. Die Refresh-Tokens von TikTok for Developers, die die Content Posting API nutzt, gelten 180 Tage. Das Ein-Jahr-Limit gilt für Refresh-Tokens der API for Business, deren verbleibende Sekunden in refresh_token_expires_in erscheinen.
Lässt sich ein abgelaufenes TikTok-Refresh-Token erneuern?
Nein. Die Lösung von TikTok für 40103 ist eine neue Autorisierung durch den Kontoinhaber, die ein neues Access-Token und ein neues Refresh-Token ausstellt.
Sieht der Kontoinhaber die Berechtigungsseite von TikTok erneut?
Standardmäßig nicht. Hat er dieselben Berechtigungen schon einmal freigegeben, überspringt TikTok die Prüfseite und leitet mit einem neuen Autorisierungscode zurück zur App.
Was passiert mit Aufrufen, nachdem das Refresh-Token abgelaufen ist?
Die Aufrufe funktionieren weiter, bis das aktuelle Access-Token sein Tagesende erreicht. Danach schlagen sie mit 40102 fehl, da sich das Token nicht mehr erneuern lässt.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am