Échecs de publication TikTok : spam_risk_too_many_posts, picture_size_check_failed et autres motifs d'échec
TikTok indique la cause d'un échec dans reason, sur l'endpoint de statut de l'API for Business, ou dans fail_reason sur la Content Posting API. Les échecs de contrôle, comme picture_size_check_failed, signifient que le fichier ne respecte pas une règle de format et doit être modifié ; video_pull_failed signifie que TikTok n'a pas pu télécharger le fichier dans l'heure ; spam_risk_too_many_posts signifie que trop de publications API ont été faites en 24 heures. Un échec marqué internal peut simplement être relancé.
easyCoexistence suit chaque publication TikTok qu'il publie jusqu'à ce que TikTok la termine ou la fasse échouer, pour Claude, ChatGPT ou votre propre plateforme : un échec arrive avec le motif de TikTok par e-mail, sur l'écran Publications et sous forme d'événement post.failed, prêt à être relancé.
Le champ /business/publish/status/ n'est renvoyé que lorsque le statut est FAILED, avec des valeurs comme frame_rate_check_failed.
Le nom que donne la Content Posting API à ce même champ, dans les réponses de /v2/post/publish/status/fetch/.
Délai de téléchargement au terme duquel TikTok fait échouer une publication avec video_pull_failed ou photo_pull_failed.
Fenêtre à l'origine de spam_risk_too_many_posts ; TikTok suggère de publier cette publication depuis son application mobile.
Le plus souvent, easyCoexistence envoie un e-mail au titulaire pour une publication TikTok en échec sur un canal ; la publication attend sous « À traiter ».
Où TikTok indique-t-il pourquoi une publication a échoué ?
Après l'appel de publication, qui ne fait que lancer la tâche : son code 0 signifie que TikTok l'a acceptée, pas que la publication sera en ligne. GET /business/publish/status/ renvoie alors FAILED avec reason, et une application abonnée aux webhooks de publication reçoit post.publish.failed avec ce même motif et le publish_id. L'endpoint /v2/post/publish/status/fetch/ de la Content Posting API renvoie ce champ sous le nom fail_reason :
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"reason": "frame_rate_check_failed",
"status": "FAILED"
}
}Que signifie chaque motif d'échec, et comment le corriger ?
Les motifs de TikTok, tels que décrits dans sa référence des événements de publication, avec la correction associée à chacun. Les quatre premiers sont des contrôles que TikTok effectue sur le fichier après le téléchargement, tous marqués comme non relançables. La table des échecs de TikTok indique encore 60 secondes comme durée maximale pour duration_check_failed, alors que l'endpoint vidéo en documente 600, ou la valeur propre au compte, max_video_post_duration_sec :
| What TikTok found | The fix | |
|---|---|---|
| file_format_check_failed | The file's format breaks TikTok's specifications | MP4, MOV or WebM video; JPG, JPEG or WebP photos |
| duration_check_failed | The video's length is outside the limits | At least 3 seconds, within the account's maximum |
| frame_rate_check_failed | Below 23 or above 60 frames per second | Export at 23 to 60 FPS |
| picture_size_check_failed | Height or width under 360 pixels | At least 360 pixels on each side |
| video_pull_failed, photo_pull_failed | The download failed or ran past one hour | A public URL that is not bandwidth-limited, then a retry |
| internal | Part of TikTok's service was unavailable | A retry |
| auth_removed | The owner removed the app's access mid-processing | No retry; the owner authorizes the app again |
| spam_risk_too_many_posts | Too many API posts in the last 24 hours | Posting from the TikTok mobile app, or waiting |
| spam_risk_user_banned_from_posting | The account is banned from making new posts | No retry while the account cannot post |
| spam_risk_text | The caption reads as risky or spammy | New text before posting again |
| spam_risk | High spam risk, such as attempts made too often | No retry, as TikTok advises |
| publish_cancelled | The upload or download was cancelled | Publishing again if the post is still wanted |
Quels échecs peuvent être relancés ?
Ceux causés par le téléchargement ou par TikTok lui-même. Les autres demandent un autre fichier ou une autre légende, une pause, ou rien du tout :
- Relancer tel quel : internal, et
video_pull_failedouphoto_pull_failedune fois l'URL publique et assez rapide. - Relancer avec un nouveau fichier :
file_format_check_failed,duration_check_failed,frame_rate_check_failedetpicture_size_check_failed. - Relancer avec une nouvelle légende :
spam_risk_text. - Attendre, ou publier depuis l'application TikTok :
spam_risk_too_many_posts. - Ne pas relancer :
auth_removedetspam_risk, comme le conseille TikTok, ouspam_risk_user_banned_from_posting.
En quoi les échecs de la Content Posting API diffèrent-ils ?
Mêmes motifs, autre champ et autre endpoint, et refus intervenant avant le début du traitement. /v2/post/publish/status/fetch/ renvoie fail_reason, autorise 30 requêtes par minute et par token utilisateur, et ajoute un conseil de non-relance pour spam_risk_user_banned_from_posting et spam_risk_text. Plusieurs refus arrivent plutôt à l'appel d'initialisation, avec un HTTP 403 :
spam_risk_too_many_posts: le créateur a atteint le plafond quotidien de publications de l'API.unaudited_client_can_only_post_to_private_accounts: une application non auditée a tenté de publier pour un compte public.url_ownership_unverified:PULL_FROM_URLdepuis un domaine ou un préfixe que l'application n'a pas vérifié.privacy_level_option_mismatch: unprivacy_levelmanquant ou hors des options du créateur.reached_active_user_cap: l'application a atteint son quota quotidien d'utilisateurs actifs pour la publication.
Qu'est-ce qui échoue avant que TikTok ne voie la publication ?
Ce qu'easyCoexistence peut détecter en premier, avec un message propre plutôt qu'un motif TikTok. Le média d'une publication programmée est copié au moment de la programmation ; un lien qui renvoie une page web, une réponse 404, le mauvais type, ou un fichier de plus de 30 Mo pour une image ou de plus de 1 Go pour une vidéo est alors refusé. Les liens d'image se terminant par .png, .gif, .bmp, .heic, .avif ou .svg sont refusés avant tout envoi, un canal qui doit être reconnecté au moment de la publication échoue avec reconnect, et la suppression d'un canal annule ses publications programmées.
Comment easyCoexistence signale-t-il une publication TikTok en échec ?
Par sa file de publication, qui suit chaque publication TikTok après l'appel de publication, en consultant /business/publish/status/ environ toutes les 20 secondes jusqu'à PUBLISH_COMPLETE. Un statut FAILED fait échouer la publication, dont le message d'erreur mentionne le motif TikTok entre parenthèses, comme frame_rate_check_failed, et chaque échec porte un failure_kind :
- refused : TikTok a répondu non, comme pour un statut FAILED et son motif.
- uncertain : l'appel de publication n'a pas reçu de réponse claire, ou TikTok n'a pas confirmé dans les 2 heures, de sorte que la publication peut être en ligne (
may_be_published). - reconnect : TikTok a refusé le token du compte, qui doit être reconnecté.
- internal : easyCoexistence a échoué avant de transmettre la publication, donc rien n'est parti.
Comment retrouver et relancer une publication en échec ?
Le titulaire reçoit un e-mail pour un échec détecté en arrière-plan, au plus un par canal toutes les 3 heures, et l'URL d'événements d'une plateforme reçoit post.failed. La publication apparaît sous « À traiter » sur l'écran Publications, avec Relancer, Reconnecter et Ignorer, et list_scheduled_posts la renvoie à Claude ou à ChatGPT. retry_scheduled_post la publie de nouveau, immédiatement, à partir des fichiers conservés 7 jours après un échec ; lorsque may_be_published vaut true, consultez d'abord list_social_posts et ne passez confirm que si la publication est absente. Une publication qui demande un nouveau fichier ou une nouvelle légende est reprogrammée à la place.
list_scheduled_posts { "account_id": "<ACCOUNT_ID>", "status": ["failed"] }
retry_scheduled_post { "post_id": "<POST_ID>" }
// may_be_published is true and the post is not on the account
retry_scheduled_post { "post_id": "<POST_ID>", "confirm": true }Erreurs courantes
- Relancer un échec de contrôle avec le même fichier. TikTok marque les échecs de format, de durée, de fréquence d'images et de taille d'image comme non relançables.
- Relancer spam_risk_too_many_posts tout de suite. TikTok compte les publications API sur 24 heures et suggère de publier depuis l'application mobile.
- Relancer une publication marquée may_be_published sans vérifier. TikTok a peut-être déjà publié ; consultez les dernières publications du compte, sinon elle sera publiée deux fois.
- Chercher fail_reason dans l'API for Business. Son endpoint de statut nomme le champ reason ; fail_reason appartient à la Content Posting API.
De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Que signifie picture_size_check_failed sur TikTok ?
TikTok a téléchargé la publication et constaté que son image mesure moins que le minimum de 360 pixels en hauteur et en largeur ; il faut un fichier plus grand, car TikTok marque cet échec comme non relançable.
Qu'est-ce que video_pull_failed ?
TikTok n'a pas pu télécharger la vidéo depuis son URL, ou pas dans le délai d'une heure. Vérifiez que l'URL est publique et non limitée en bande passante, puis relancez.
Combien de temps dure spam_risk_too_many_posts ?
TikTok compte les publications faites via l'API sur les dernières 24 heures, soit environ 15 par jour et par compte, et suggère en attendant de publier depuis l'application mobile TikTok.
easyCoexistence relance-t-il automatiquement une publication TikTok en échec ?
Non, pas après un statut FAILED de TikTok : la publication attend sous « À traiter », le titulaire reçoit un e-mail, et Relancer ou retry_scheduled_post l'envoie de nouveau.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le