AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Warum eine TikTok-API-Verbindung nicht mehr funktioniert und wie Sie sie am Laufen halten

Eine TikTok-API-for-Business-Verbindung funktioniert nicht mehr, wenn ihr 24-Stunden-Access-Token nicht erneuert wird, das einjährige Refresh-Token abläuft, der Kontoinhaber den Zugriff der App entfernt oder das gesendete Token fehlt oder falsch ist. TikTok meldet die Token-Fälle als 40102, 40103, 40104 und 40105. Wer früh erneuert, jedes Konto nach Zeitplan prüft und den Inhaber bittet, vor Jahresende erneut zu autorisieren, hält die Verbindung am Leben.

easyCoexistence hält jede TikTok-Verbindung eigenständig am Leben: Es erneuert das 24-Stunden-Token rechtzeitig, prüft das Konto etwa alle 6 Stunden, und wenn TikTok das Token ablehnt, markiert es den Kanal als Erneut verbinden erforderlich und schickt Ihnen eine E-Mail, für Claude, ChatGPT oder Ihre eigene Plattform.

24 hours

Lebensdauer des Access-Tokens eines TikTok-Kontos aus der API for Business; /tt_user/oauth2/refresh_token/ erneuert es.

1 year

Lebensdauer des Refresh-Tokens; nach Ablauf muss der Kontoinhaber die App erneut autorisieren.

auth_removed

Fehlergrund, wenn der Inhaber den Zugriff der App entfernt, während TikTok einen Beitrag verarbeitet; TikTok rät davon ab, es erneut zu versuchen.

comment.update

Ereignisse, die TikTok für ein Konto nicht mehr sendet, sobald die Autorisierung des Inhabers abläuft oder widerrufen wird.

5 reasons

Gründe, warum das Ereignis authorization.removed von TikTok for Developers ausgelöst wird: Der Nutzer trennt die Verbindung, das Konto wird gelöscht, das Alter ändert sich, eine Sperre erfolgt oder der Entwickler widerruft die Berechtigung.

6 hours

Wie oft easyCoexistence jedes verbundene TikTok-Konto prüft; es erneuert das 24-Stunden-Token selbstständig und schickt Ihnen eine E-Mail, wenn ein erneutes Verbinden nötig ist.

Warum bricht eine TikTok-API-Verbindung ab?

Aus einigen wenigen Gründen, die meisten davon an die Tokens des Kontos oder die Zustimmung des Inhabers gebunden. Manche beenden die Verbindung vollständig, andere lassen sie halb funktionieren, wobei manche Aufrufe abgelehnt werden und die übrigen weiterhin antworten:

Access token expired24 hours passed without a renewal, and calls return 40102
Refresh token expiredIts year ended: renewal returns 40103 until the owner signs in again
Access removedThe owner chose Remove access in TikTok, or the app revoked the token
Wrong tokenMissing from the request (40104), or invalid or incorrect (40105)
Missing permissionA call outside the granted permissions returns 40001
Account level changedData tied to Advanced Access or verification is no longer available
App access revokedTikTok can revoke an app's Accounts API access for misuse, without notice

Welchen Fehler gibt jede Ursache zurück, und was behebt ihn?

TikTok nennt die meisten davon im Feld code, und zwar in einer HTTP-200-Antwort statt eines Fehlerstatus; der Veröffentlichungsstatus fügt einen eigenen Fehlergrund hinzu. 40100 steht in der Tabelle, weil ein gedrosselter Aufruf wie eine verlorene Verbindung aussehen kann. Was jeder Code bedeutet und wie er behoben wird:

What it meansThe fix
40102The access token is past its 24 hoursRenew with the refresh token, store both new tokens, repeat the call
40103The refresh token has expiredA new authorization by the owner; nothing renews it
40104The request carried no access tokenA bug in the request: send the Access-Token header
40105The access token is invalid or incorrectCheck what was sent, renew, then ask the owner to authorize again
40107The refresh token is invalid or incorrectSend the refresh token from the latest response, or a new authorization
40131Authentication failed at a token endpointCheck the app ID and secret, then the code or the refresh token
40001A permission or scope is missingAdd it to the app, then have the owner authorize again
auth_removedAccess was removed while a post was processingNo retry; publish again after a new authorization
40100Throttled, not disconnectedPause the endpoint 5 minutes; the token still works

Wie lange halten die Tokens, und wann sollten Sie erneuern?

Bei der API for Business gilt das Access-Token 24 Stunden; expires_in in jeder Token-Antwort gibt die verbleibenden Sekunden an. Das Refresh-Token gilt ein Jahr mit eigenem Countdown in refresh_token_expires_in. Erneuern Sie deutlich vor Tagesende, nach Zeitplan und nicht erst nach einem fehlgeschlagenen Aufruf, und speichern Sie bei jeder Erneuerung das zurückgegebene Refresh-Token, da TikTok in seinem Hinweis zu diesem Feld empfiehlt, es aufzubewahren. Behandeln Sie refresh_token_expires_in als Frist: Im Erneuerungsbeispiel von TikTok läuft der Wert herunter, statt ein neues Jahr zu beginnen.

Was passiert, wenn der Inhaber den Zugriff der App entfernt?

Die App verliert die Berechtigungen der Accounts API, die der Inhaber gewährt hat, sodass Aufrufe mit diesem Token nicht mehr funktionieren. TikTok dokumentiert kein Ereignis der API for Business, das dies ankündigt. Der Inhaber kann es jederzeit in der TikTok-App tun, unter Einstellungen und Datenschutz, Sicherheit, App-Berechtigungen verwalten, Zugriff entfernen. Die Anzeichen zeigen sich an anderer Stelle: Ein Beitrag, den TikTok gerade verarbeitet, schlägt mit auth_removed fehl, wobei TikTok davon abrät, es erneut zu versuchen, und comment.update-Ereignisse für das Konto bleiben aus.

Was bewirkt ein Wechsel des Kontotyps für die Verbindung?

TikTok verknüpft in seiner Dokumentation keinen Token-Fehler damit; was sich ändert, ist die Antwort der API. Daten wie unique_video_views, daily_new_followers und audience_activity erfordern Advanced Access oder ein verifiziertes Business-Konto, ebenso die Mentions-API und die Business-Messaging-API, und privacy_level_options eines privaten Kontos lässt PUBLIC_TO_EVERYONE weg. Seit dem 16. Oktober 2026 liefert is_business_account nur für verifizierte Business-Konten den Wert true, und has_advanced_access meldet den Advanced Access. Wenn beide unter user.account.type gelesen werden, zeigt sich ein Wechsel, bevor ein Aufruf daran scheitert.

Wie erkennen Sie eine tote Verbindung, bevor es Ihre Kunden tun?

Mit Prüfungen, die laufen, unabhängig davon, ob gerade jemand postet:

  • Ein leichter Aufruf pro Konto nach Zeitplan, etwa /business/get/ mit dem Feld username, der einen Token-Fehler zurückgibt, sobald das Token nicht mehr funktioniert.
  • /tt_user/token_info/get/, das keine Berechtigung braucht und den Scope des Tokens zurückgibt, um zu bestätigen, dass die Berechtigungen noch abdecken, was Ihre Funktionen aufrufen.
  • refresh_token_expires_in wird bei jeder Antwort in ein Datum umgewandelt, mit einer Erinnerung an den Inhaber einige Wochen vorher.
  • Stille bei comment.update für ein Konto, das sonst Kommentare erhält, da TikTok diese Ereignisse einstellt, sobald die Autorisierung abläuft oder widerrufen wird.
  • 40102, 40103, 40104 und 40105 pro Konto gezählt, damit ein ausfallendes Konto unter vielen auffällt.

Wie verbinden Sie ein Konto erneut?

Indem Sie die Autorisierung erneut für dasselbe Konto ausführen. Teilen Sie die Autorisierungs-URL des TikTok-Kontoinhabers mit einem state-Wert, der die Rückkehr dem Konto zuordnet, und disable_auto_auth=1, wenn der Inhaber die Berechtigungsseite erneut sehen soll. Tauschen Sie den neuen auth_code innerhalb von 10 Minuten unter /tt_user/oauth2/token/ ein und ersetzen Sie dann beide gespeicherten Tokens. open_id ist die anwendungsspezifische ID von TikTok für das Konto. Gleichen Sie die neuen Tokens daher anhand dieser ID mit dem gespeicherten Datensatz ab, statt einen zweiten anzulegen.

Laufen Verbindungen der Content Posting API genauso ab?

Nein. TikTok for Developers, das die Content Posting API und die Display API bereitstellt, hat seine Token-Seiten am 2. November 2026 aktualisiert: Benutzer-Access-Tokens laufen innerhalb von 2 Stunden ab, und Refresh-Tokens gelten 180 Tage ab der ersten Ausstellung. Die Refresh-Tokens rotieren: Jede erfolgreiche Erneuerung liefert ein neues und macht das gesendete sofort ungültig. Verwendet ein Server weiterhin ein ersetztes Token, schlagen spätere Erneuerungen fehl, und der Nutzer muss erneut autorisieren. Ein ungültiges Refresh-Token scheitert mit invalid_grant, ein ungültiges Access-Token mit access_token_invalid und HTTP 401. Der Webhook authorization.removed nennt den Grund, warum ein Nutzer ausgestiegen ist.

Was tut easyCoexistence, um eine TikTok-Verbindung am Leben zu halten?

Es erneuert und prüft selbstständig und sagt Ihnen, wenn nur der Inhaber es beheben kann:

  • Erneuerung: vor einem Aufruf, wenn weniger als 15 Minuten verbleiben, und bei einer Prüfung, wenn weniger als 8 Stunden verbleiben; das neue Refresh-Token und sein Ablaufdatum werden jedes Mal gespeichert.
  • Eine Erneuerung gleichzeitig pro Konto, sodass gleichzeitig eintreffende Aufrufe sie gemeinsam nutzen.
  • Die Prüfung: ein /business/get/-Aufruf für den username des Kontos etwa alle 6 Stunden.
  • Ein abgelehntes Token, 40102, 40104 oder 40105: Der Kanal zeigt Erneut verbinden erforderlich, der Inhaber erhält eine E-Mail, und eine Plattform erhält channel.disconnected, mit der Meldung von TikTok als disconnected_reason.
  • Bis dahin antworten Tools, dass das Konto erneut verbunden werden muss, und ein geplanter Beitrag schlägt mit dem Status reconnect fehl, statt TikTok zu erreichen.
  • Erneutes Verbinden: Klicken Sie auf der Seite des Kanals auf TikTok verbinden oder starten Sie eine neue Verbindungssitzung. Die Anmeldung erfolgt erneut, und account_id sowie das Ereignisziel bleiben gleich.

So richten Sie es ein

  1. 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.
  2. 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.
  3. Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
  4. 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.
  5. Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.

Häufige Fehler

  • Ein stilles Kommentar-Webhook mit einem stillen Konto verwechseln. TikTok stellt comment.update für ein Konto ein, sobald seine Autorisierung endet; prüfen Sie daher das Konto, statt auf Ereignisse zu warten.
  • Beim erneuten Verbinden einen neuen Datensatz anlegen. Gleichen Sie die neuen Tokens über open_id ab, die anwendungsspezifische ID von TikTok für das Konto, und aktualisieren Sie den gespeicherten Datensatz an Ort und Stelle, wobei Verlauf und Einstellungen erhalten bleiben.
  • 40103 oder 40107 mit demselben Refresh-Token erneut versuchen. Keiner der beiden Fehler verschwindet durch Wiederholung: Der erste braucht eine neue Autorisierung, der zweite das Refresh-Token aus der neuesten Antwort oder eine neue Autorisierung.
  • 40100 als verlorene Verbindung deuten. Es ist ein gedrosselter Aufruf; pausieren Sie den Endpunkt 5 Minuten oder bis 00:00 UTC nach einem Tageslimit, dann funktioniert dasselbe Token weiter.
Mit EasyCoexistence

Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit den ersten 3 Tagen kostenlos.

Häufig gestellte Fragen

Kann eine TikTok-API-Verbindung ohne den Inhaber ewig bestehen?

Nein. Die Erneuerung trägt sie höchstens durch das Jahr des Refresh-Tokens; danach ist der dokumentierte Weg von TikTok eine neue Autorisierung durch den Kontoinhaber.

Warum sind TikTok-Verbindungen bei mehreren Konten gleichzeitig ausgefallen?

Prüfen Sie zuerst die App, nicht die Konten: 40113 bedeutet, dass die App gesperrt ist oder ihre ID und ihr Secret nicht übereinstimmen, und TikTok kann den Zugriff einer App auf die Accounts API bei Missbrauch widerrufen.

Erfordert ein neues Feature das erneute Verbinden von TikTok-Konten?

Ja, wenn es einen Scope braucht, den der Inhaber nie gewährt hat. Ein Token behält die bei der Autorisierung genehmigten Scopes, daher autorisiert der Inhaber die App erneut, um einen hinzuzufügen.

Was passiert mit geplanten TikTok-Beiträgen, während ein Konto erneut verbunden werden muss?

Bei easyCoexistence schlagen sie zu ihrem Zeitpunkt mit dem Status reconnect fehl, statt TikTok zu erreichen, der Inhaber erhält eine E-Mail, und Erneut versuchen sendet sie, sobald das Konto wieder verbunden ist.

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