Erreurs
Format
Toutes les erreurs répondent en JSON avec un code stable :
{ "error": "api_key_expired" }Erreurs d'authentification
| Statut | Code | Cause |
|---|---|---|
| 401 | invalid_api_key | Clé inconnue ou mal formée |
| 401 | api_key_revoked | Clé révoquée depuis le dashboard |
| 401 | api_key_expired | Durée de vie de la clé dépassée — créez-en une nouvelle |
| 403 | insufficient_scope | La clé ne porte pas le scope requis par la route |
| 429 | rate_limit_exceeded | Plus de 30 requêtes/minute sur cette clé |
Erreurs métier
| Statut | Code | Cause |
|---|---|---|
| 400 | fetch_failed | URL média inaccessible, redirection ou schéma non http(s) |
| 400 | not_an_image | Contenu non décodable comme image |
| 400 | unsupported_media_type | Ni image ni vidéo MP4/MOV/WebM reconnue |
| 400 | media_too_large | Image > 20 Mo, ou vidéo > 128 Mo envoyée par son adresse (au-delà, utilisez l’envoi direct) |
| 400 | unsupported_file_type | Envoi direct (/v1/media/upload-url) : type de fichier non accepté |
| 413 | file_too_large | Envoi direct : vidéo > 512 Mo, image > 20 Mo, PDF > 25 Mo |
| 400 | await_media_with_media_urls | awaitMedia et mediaUrls dans la même publication |
| 400 | same_media_post_not_waiting | sameMediaAs ne désigne pas une publication de l’espace qui attend encore son fichier |
| 413 | payload_too_large | Corps de requête > 30 Mo |
| 404 | channel_tiktok_not_found | Aucun compte TikTok actif connecté à l'espace de travail |
| 400 | channel_no_token | Le canal TikTok n’a pas de jeton — reconnectez le compte |
| 401 | channel_tiktok_needs_reauth | Jeton TikTok invalide — reconnectez le compte depuis le dashboard |
| 400 | publish_failed | Rejet TikTok à l’initialisation (détails dans le message) |
| 404 | workspace_not_found | Aucun espace de travail pour ce compte |
| 502 | storage_error | Échec du stockage média — réessayez |
| 400 | comments_unsupported_platform | Commentaires : le compte n’est ni une Page Facebook ni un compte Instagram |
| 403 | comments_permission_missing | Commentaires : le compte n’a pas ce droit, renouvelez son accès depuis le tableau de bord |
| 404 | comment_not_found | Commentaire introuvable ou pas sous une publication de ce compte : rien n’est envoyé |
| 400 | comment_too_long | Réponse au delà de 8 000 caractères (Facebook) ou 2 200 (Instagram) |
Échecs TikTok asynchrones
Après un init accepté, TikTok peut échouer pendant le téléchargement des images. Le statut passe alors à FAILED avec un failReason : photo_pull_failed (URL inaccessible côté TikTok), picture_size_check_failed (dimensions hors bornes), file_format_check_failed (format refusé — impossible si vous passez par /v1/media), video_pull_failed (vidéo inaccessible ou codec refusé), spam_risk_too_many_posts (cadence trop élevée — réduisez la fréquence), spam_risk_too_many_pending_shares (plus de 5 brouillons en attente sur 24 h — demandez à l'utilisateur de publier ou vider sa boîte). Ne réessayez pas automatiquement : la plupart de ces erreurs sont permanentes pour un même contenu.