TikTok-API-FehlerreferenzVollständiger Leitfaden zur Fehlerbehebung mit Lösungen

Umfassende Referenz für TikTok API-Fehler. Finden Sie Lösungen und beheben Sie häufige Integrationsprobleme.

25 Fehlercodes
7 Kategorien
API v1

Fehlerkategorien

Authentifizierung

3 errors

Spam

6 errors

Video Format

6 errors

Media

3 errors

Rate Limit

2 errors

App Status

3 errors

Server

2 errors

Alle Fehlercodes

#Authentifizierung

access_token_invalidrefresh-token

TikTok-Zugriffstoken ist ungültig. Bitte verbinden Sie Ihr TikTok-Konto erneut.

Lösung:

Ihr Zugriffstoken ist nicht mehr gültig. Gehen Sie zu den Kontoeinstellungen und verbinden Sie Ihr TikTok-Konto erneut, um ein neues gültiges Token zu erhalten.

scope_not_authorizedrefresh-token

Erforderliche TikTok-Berechtigungen fehlen. Bitte verbinden Sie sich erneut mit allen erforderlichen Bereichen.

Lösung:

Sie haben nicht alle erforderlichen Berechtigungen erteilt. Stellen Sie bei der erneuten Verbindung sicher, dass Sie alle angeforderten Bereiche genehmigen, einschließlich video.upload und user.info.basic.

scope_permission_missedrefresh-token

Zusätzliche Berechtigungen erforderlich, bitte authentifizieren Sie sich erneut.

Lösung:

Zusätzliche Berechtigungen werden für diesen Vorgang benötigt. Verbinden Sie Ihr TikTok-Konto erneut und stellen Sie sicher, dass alle Berechtigungen erteilt werden.

#Spam

spam_risk_user_banned_from_postinguser-error

Konto vom Posten gesperrt. Bitte überprüfen Sie Ihren TikTok-Kontostatus.

Lösung:

Ihr TikTok-Konto wurde vom Posten eingeschränkt. Melden Sie sich direkt bei TikTok an, um zu sehen, ob es Warnungen gibt. Möglicherweise müssen Sie gegen die Einschränkung Einspruch einlegen.

spam_risk_textuser-error

TikTok hat potenziellen Spam im Beitragstext erkannt.

Lösung:

Ihre Bildunterschrift oder Ihr Text wurde als Spam markiert. Vermeiden Sie sich wiederholende Inhalte, übermäßige Links oder werbliche Sprache. Versuchen Sie, anderen Inhalt zu posten.

spam_risk_too_many_postsuser-error

Tägliches Post-Limit erreicht. Bitte versuchen Sie es morgen erneut.

Lösung:

Sie haben das tägliche Posting-Limit von TikTok überschritten. Warten Sie 24 Stunden, bevor Sie erneut posten. Erwägen Sie, Ihre Posts auf mehrere Tage zu verteilen.

spam_risk_too_many_pending_shareuser-error

The daily upload cap from the API is reached for the current user.

Lösung:

To reduce spamming, TikTok limits the number of videos that can be uploaded via API that are not pending approval and posting by the creator. There may be at most 5 pending shares within any 24-hour period.

spam_riskuser-error

TikTok hat potenziellen Spam erkannt.

Lösung:

Das Spam-Erkennungssystem von TikTok hat Ihren Inhalt markiert. Stellen Sie sicher, dass Ihr Inhalt original ist und den Community-Richtlinien von TikTok folgt. Vermeiden Sie sich wiederholende Posts.

reached_active_user_capuser-error

Tägliches Aktive-Benutzer-Kontingent erreicht, bitte versuchen Sie es später erneut.

Lösung:

Ihre App hat ihr tägliches Limit für aktive Benutzer erreicht. Dies wird von TikTok basierend auf dem Status Ihrer App festgelegt. Warten Sie 24 Stunden oder fordern Sie eine Kontingenterhöhung an.

#Video Format

file_format_check_faileduser-error

Dateiformat ist ungültig. Bitte überprüfen Sie die TikTok-Videospezifikationen.

Lösung:

Ihr Videoformat wird nicht unterstützt. TikTok benötigt das MP4- oder WebM-Format. Konvertieren Sie Ihr Video und stellen Sie sicher, dass es den Spezifikationen von TikTok entspricht.

duration_check_faileduser-error

Videodauer ist ungültig. Bitte überprüfen Sie die TikTok-Videospezifikationen.

Lösung:

Die Videodauer muss zwischen 3 Sekunden und 10 Minuten liegen. Kürzen Sie Ihr Video, um diese Grenzen einzuhalten.

frame_rate_check_faileduser-error

Video-Framerate ist ungültig. Bitte überprüfen Sie die TikTok-Videospezifikationen.

Lösung:

TikTok benötigt eine Framerate zwischen 23-60 fps. Kodieren Sie Ihr Video mit einer unterstützten Framerate neu.

picture_size_check_faileduser-error

Bild-/Videogröße ist ungültig, muss mindestens 720p sein.

Lösung:

Ihre Videoauflösung ist zu niedrig. TikTok benötigt eine Mindestauflösung von 720p. Verwenden Sie eine höherwertige Videoquelle.

video durationuser-error

Videodauer überschreitet die Limits von TikTok. Bitte verwenden Sie ein kürzeres Video.

Lösung:

Ihr Video ist zu lang. Die maximale Dauer beträgt 10 Minuten. Bearbeiten Sie Ihr Video, um es kürzer zu machen, oder teilen Sie es in mehrere Teile auf.

file sizeuser-error

Dateigröße überschreitet die Limits von TikTok. Bitte verwenden Sie eine kleinere Datei.

Lösung:

Die maximale Dateigröße beträgt normalerweise 287 MB für Videos. Komprimieren Sie Ihr Video oder reduzieren Sie seine Qualität, um die Größenbeschränkung einzuhalten.

#Media

video_pull_faileduser-error

Video konnte nicht von der URL abgerufen werden. Bitte überprüfen Sie, ob die Video-URL zugänglich ist.

Lösung:

TikTok konnte Ihr Video nicht von der bereitgestellten URL herunterladen. Stellen Sie sicher, dass die URL öffentlich zugänglich ist, korrekte Header zurückgibt und die Datei gültig ist.

photo_pull_faileduser-error

Foto konnte nicht von der URL abgerufen werden. Bitte überprüfen Sie, ob die Foto-URL zugänglich ist.

Lösung:

TikTok konnte Ihr Bild nicht herunterladen. Überprüfen Sie, ob die URL öffentlich zugänglich ist und den korrekten Content-Type-Header (image/jpeg oder image/png) zurückgibt.

invalid_file_uploaduser-error

Ungültiges Dateiformat oder Spezifikationen nicht erfüllt.

Lösung:

Ihre Datei erfüllt nicht die Anforderungen von TikTok. Überprüfen Sie, ob es sich um eine gültige Video-/Bilddatei in einem unterstützten Format handelt und alle Spezifikationen erfüllt sind.

#Rate Limit

rate_limit_exceededretry

TikTok-Ratenlimit überschritten. Bitte versuchen Sie es in einigen Augenblicken erneut.

Lösung:

Sie haben zu viele Anfragen zu schnell gestellt. Warten Sie einige Minuten, bevor Sie es erneut versuchen. Das System wird automatisch für Sie wiederholen.

too many requestsretry

TikTok-Ratenlimit überschritten. Bitte versuchen Sie es in einigen Augenblicken erneut.

Lösung:

TikTok limitiert Ihre Anfragen. Reduzieren Sie die Häufigkeit der API-Aufrufe und implementieren Sie exponentielles Backoff in Ihrer Wiederholungslogik.

#App Status

unaudited_client_can_only_post_to_private_accountsuser-error

Ihre App befindet sich im Entwicklungsmodus und kann nur privat posten. Bitte zur TikTok-Überprüfung einreichen für öffentliches Posten.

Lösung:

Ihre TikTok-App ist nicht für die Produktion genehmigt. Reichen Sie Ihre App für den Überprüfungsprozess von TikTok ein, um öffentliche Posting-Funktionen zu aktivieren.

url_ownership_unverifieduser-error

URL-Eigentümerschaft nicht verifiziert, bitte verifizieren Sie die Domain-Eigentümerschaft.

Lösung:

Sie müssen die Eigentümerschaft aller externen URLs in Ihren Posts verifizieren. Fügen Sie den Verifizierungscode zu Ihrer Domain hinzu oder verwenden Sie die TikTok-Entwicklerkonsole zur Verifizierung.

privacy_level_option_mismatchuser-error

Datenschutzstufe stimmt nicht überein, bitte überprüfen Sie die Datenschutzeinstellungen.

Lösung:

Die von Ihnen angegebene Datenschutzstufe entspricht nicht den Fähigkeiten Ihrer App oder den Kontoeinstellungen. Überprüfen Sie die Berechtigungen Ihrer App und die Datenschutzeinstellungen.

#Server

internalretry

There is a problem with TikTok servers, please try again later.

Lösung:

TikTok is experiencing server issues. This is temporary. Wait a few minutes and try again. The system will automatically retry.

invalid_paramsuser-error

Invalid request parameters, please check content format.

Lösung:

One or more parameters in your request are invalid. Review the TikTok API documentation and ensure all required fields are present and correctly formatted.

Beste Praktiken

Fehlerbehandlung

  • Verwalten Sie Token-Ablauf und Aktualisierung
  • Validieren Sie Video-Spezifikationen vor dem Upload
  • Implementieren Sie Chunk-Upload für große Videos
  • Überwachen Sie Videoverarbeitungsstatus

Präventions-Tipps

  • Verwenden Sie MP4 mit H.264/H.265 Codec
  • Halten Sie Videos unter 4GB
  • Befolgen Sie TikTok Community-Richtlinien
  • Aktualisieren Sie Tokens regelmäßig

Benötigen Sie Hilfe bei der TikTok Integration?

Unsere API behandelt Fehlerszenarien automatisch mit intelligenter Wiederholungslogik und detaillierter Protokollierung.