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.

25 codes d'erreur
7 catégories
API v1

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-token

Le 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-token

Autorisations 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-token

Autorisations 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-error

Compte 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-error

TikTok 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-error

Limite 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-error

The 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-error

TikTok 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-error

Quota 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-error

Le 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-error

La 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-error

La 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-error

La 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-error

La 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-error

La 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-error

Format 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_exceededretry

Limite 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 requestsretry

Limite 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-error

Votre 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-error

Proprié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-error

Inadé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

internalretry

There 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-error

Invalid 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.