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