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.
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-tokenTikTok-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-tokenErforderliche 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-tokenZusä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-errorKonto 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-errorTikTok 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-errorTä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-errorThe 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-errorTikTok 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-errorTä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-errorDateiformat 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-errorVideodauer 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-errorVideo-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-errorBild-/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-errorVideodauer ü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-errorDateigröß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-errorVideo 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-errorFoto 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-errorUngü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_exceededretryTikTok-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 requestsretryTikTok-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-errorIhre 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-errorURL-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-errorDatenschutzstufe 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
internalretryThere 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-errorInvalid 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.