Référence des Erreurs de l'API TikTokGuide complet de dépannage avec solutions
Référence complète pour les erreurs de l'API TikTok. Trouvez des solutions pour la détection de spam, les erreurs de format vidéo, les autorisations de portée et les limites de débit.
Catégories d'Erreurs
Authentification
3 errors
Spam
6 errors
Format vidéo
6 errors
Médias
3 errors
Limite de débit
2 errors
Statut de l'application
3 errors
Server
2 errors
Tous les Codes d'Erreur
#Authentification
access_token_invalidrefresh-tokenLe jeton d'accès TikTok est invalide. Veuillez reconnecter votre compte TikTok.
Solution :
Votre jeton d'accès n'est plus valide. Allez dans les paramètres du compte et reconnectez votre compte TikTok pour obtenir un nouveau jeton valide.
scope_not_authorizedrefresh-tokenAutorisations TikTok requises manquantes. Veuillez reconnecter avec toutes les portées requises.
Solution :
Vous n'avez pas accordé toutes les autorisations requises. Lors de la reconnexion, assurez-vous d'approuver toutes les portées demandées, y compris video.upload et user.info.basic.
scope_permission_missedrefresh-tokenAutorisations supplémentaires requises, veuillez vous réauthentifier.
Solution :
Des autorisations supplémentaires sont nécessaires pour cette opération. Reconnectez votre compte TikTok et assurez-vous que toutes les autorisations sont accordées.
#Spam
spam_risk_user_banned_from_postinguser-errorCompte banni de la publication. Veuillez vérifier l'état de votre compte TikTok.
Solution :
Votre compte TikTok a été restreint de la publication. Connectez-vous directement à TikTok pour voir s'il y a des avertissements. Vous devrez peut-être faire appel de la restriction.
spam_risk_textuser-errorTikTok a détecté un potentiel spam dans le texte de la publication.
Solution :
Votre légende ou texte a été signalé comme spam. Évitez le contenu répétitif, les liens excessifs ou le langage promotionnel. Essayez de publier un contenu différent.
spam_risk_too_many_postsuser-errorLimite de publication quotidienne atteinte. Veuillez réessayer demain.
Solution :
Vous avez dépassé la limite de publication quotidienne de TikTok. Attendez 24 heures avant de publier à nouveau. Envisagez de répartir vos publications sur plusieurs jours.
spam_risk_too_many_pending_shareuser-errorThe daily upload cap from the API is reached for the current user.
Solution :
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 a détecté un potentiel spam.
Solution :
Le système de détection de spam de TikTok a signalé votre contenu. Assurez-vous que votre contenu est original et suit les directives de la communauté TikTok. Évitez les publications répétitives.
reached_active_user_capuser-errorQuota d'utilisateurs actifs quotidiens atteint, veuillez réessayer plus tard.
Solution :
Votre application a atteint sa limite quotidienne d'utilisateurs actifs. Ceci est défini par TikTok en fonction du statut de votre application. Attendez 24 heures ou demandez une augmentation de quota.
#Format vidéo
file_format_check_faileduser-errorLe format de fichier est invalide. Veuillez vérifier les spécifications vidéo de TikTok.
Solution :
Votre format vidéo n'est pas pris en charge. TikTok nécessite le format MP4 ou WebM. Convertissez votre vidéo et assurez-vous qu'elle répond aux spécifications de TikTok.
duration_check_faileduser-errorLa durée de la vidéo est invalide. Veuillez vérifier les spécifications vidéo de TikTok.
Solution :
La durée de la vidéo doit être comprise entre 3 secondes et 10 minutes. Raccourcissez votre vidéo pour qu'elle respecte ces limites.
frame_rate_check_faileduser-errorLa fréquence d'images de la vidéo est invalide. Veuillez vérifier les spécifications vidéo de TikTok.
Solution :
TikTok nécessite une fréquence d'images entre 23 et 60 fps. Réencodez votre vidéo avec une fréquence d'images prise en charge.
picture_size_check_faileduser-errorLa taille de l'image/vidéo est invalide, doit être au moins 720p.
Solution :
La résolution de votre vidéo est trop faible. TikTok nécessite une résolution minimale de 720p. Utilisez une source vidéo de meilleure qualité.
video durationuser-errorLa durée de la vidéo dépasse les limites de TikTok. Veuillez utiliser une vidéo plus courte.
Solution :
Votre vidéo est trop longue. La durée maximale est de 10 minutes. Éditez votre vidéo pour la raccourcir ou divisez-la en plusieurs parties.
file sizeuser-errorLa taille du fichier dépasse les limites de TikTok. Veuillez utiliser un fichier plus petit.
Solution :
La taille maximale du fichier est généralement de 287 Mo pour les vidéos. Compressez votre vidéo ou réduisez sa qualité pour respecter la limite de taille.
#Médias
video_pull_faileduser-errorÉchec de récupération de la vidéo depuis l'URL. Veuillez vérifier que l'URL de la vidéo est accessible.
Solution :
TikTok n'a pas pu télécharger votre vidéo depuis l'URL fournie. Assurez-vous que l'URL est accessible publiquement, renvoie les en-têtes corrects et que le fichier est valide.
photo_pull_faileduser-errorÉchec de récupération de la photo depuis l'URL. Veuillez vérifier que l'URL de la photo est accessible.
Solution :
TikTok n'a pas pu télécharger votre image. Vérifiez que l'URL est accessible publiquement et renvoie l'en-tête content-type correct (image/jpeg ou image/png).
invalid_file_uploaduser-errorFormat de fichier invalide ou spécifications non respectées.
Solution :
Votre fichier ne répond pas aux exigences de TikTok. Vérifiez qu'il s'agit d'un fichier vidéo/image valide dans un format pris en charge et qu'il répond à toutes les spécifications.
#Limite de débit
rate_limit_exceededretryLimite de débit TikTok dépassée. Veuillez réessayer dans quelques instants.
Solution :
Vous avez fait trop de requêtes trop rapidement. Attendez quelques minutes avant de réessayer. Le système réessayera automatiquement pour vous.
too many requestsretryLimite de débit TikTok dépassée. Veuillez réessayer dans quelques instants.
Solution :
TikTok limite vos requêtes. Réduisez la fréquence des appels API et implémentez un backoff exponentiel dans votre logique de réessai.
#Statut de l'application
unaudited_client_can_only_post_to_private_accountsuser-errorVotre application est en mode développement et ne peut publier que en privé. Veuillez soumettre pour examen TikTok pour une publication publique.
Solution :
Votre application TikTok n'est pas approuvée pour la production. Soumettez votre application pour le processus d'examen de TikTok pour activer les capacités de publication publique.
url_ownership_unverifieduser-errorPropriété de l'URL non vérifiée, veuillez vérifier la propriété du domaine.
Solution :
Vous devez vérifier la propriété de toutes les URL externes dans vos publications. Ajoutez le code de vérification à votre domaine ou utilisez la console développeur TikTok pour vérifier.
privacy_level_option_mismatchuser-errorInadéquation du niveau de confidentialité, veuillez vérifier les paramètres de confidentialité.
Solution :
Le niveau de confidentialité que vous avez spécifié ne correspond pas aux capacités de votre application ou aux paramètres du compte. Révisez les autorisations de votre application et les paramètres de confidentialité.
#Server
internalretryThere is a problem with TikTok servers, please try again later.
Solution :
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.
Solution :
One or more parameters in your request are invalid. Review the TikTok API documentation and ensure all required fields are present and correctly formatted.
Meilleures Pratiques
Gestion des Erreurs
- →Implémenter des stratégies d'évitement de détection de spam
- →Valider le format et les spécifications vidéo avant le téléchargement
- →Gérer les limites de débit avec un recul exponentiel
- →Soumettre l'application pour approbation en production
Conseils de Prévention
- →Utiliser le format MP4/WebM, 720p minimum, 23-60 fps
- →Garder les vidéos de 3 secondes à 10 minutes
- →Éviter le contenu répétitif ou promotionnel
- →Vérifier la propriété du domaine pour les URLs externes
Besoin d'Aide pour TikTok l'Intégration?
Notre API gère automatiquement les scénarios d'erreur avec une logique de nouvelle tentative intelligente et une journalisation détaillée.