Vérifié le 2026-11-10 · Version API 2026-11-09 · Lire le Markdown
Erreurs, tentatives et récupération
Les erreurs d'API utilisent { "error": { "code": "…", "message": "…", "requestId": "…" } }
avec des erreurs de champs, des erreurs de destination, des indices de retry et des handoffs d'action
optionnels. Conservez requestId pour le support. Ne journalisez pas les identifiants, les URL de
téléversement signées ni le contenu sensible des requêtes lors de la collecte de diagnostics.
| Réponse | Récupération |
|---|---|
401 unauthenticated | Vérifiez une clé de produit manquante, malformée ou révoquée |
403 forbidden_scope / account_not_allowed | Examinez les scopes de la clé et l'accès aux destinations |
402 account_limit, seat_limit, storage_limit | Examinez les droits de l'espace de travail et l'utilisation des ressources |
402 subscription_inactive / trial_expired | Résolvez l'état de facturation ; préservez les brouillons et le travail en file |
409 revision_conflict | Lisez la version actuelle, examinez les changements et réappliquez intentionnellement |
409 idempotency_conflict | La clé a été réutilisée avec un corps différent ; réconciliez l'opération d'origine |
409 consent_required | Demandez à une personne autorisée de compléter le handoff de revue fourni |
409 too_late_to_cancel | Inspectez le statut réel de la livraison ; ne prétendez pas que l'annulation a réussi |
media_expired / media_deleting | Retéléversez les originaux et mettez à jour le brouillon |
422 validation_failed | Corrigez les champs structurés ou les problèmes par destination |
429 rate_limited | Respectez Retry-After ; réduisez la concurrence et utilisez un backoff |
submission_unknown | Réconciliez le résultat externe existant avant de tenter une autre soumission |
Tentatives sûres de mutation
Générez une clé d'idempotence avant la première mutation et stockez sa requête exacte.
Si la réponse est perdue, l'opération a peut-être déjà réussi. Rejouez la
même requête avec la même clé ; ne générez jamais une nouvelle clé simplement parce que le
réseau a expiré. Les outils de mutation MCP renvoient leur clé en écho, y compris dans les
échecs transport_outcome_unknown. L'adaptateur ne retente pas automatiquement les mutations.
Les limites techniques de vitesse de l'espace de travail ne sont pas des crédits de publication. Utilisez
/usage pour le plan actuel et les informations de débit. Ralentissez pour les erreurs transitoires
uniquement quand c'est approprié ; retenter des erreurs d'autorisation, de validation ou de
consentement humain sans changer leur cause ne sert à rien.
Succès partiel et observation
Un lot de publication/planification accepté est un ensemble de livraisons indépendantes. Conservez les reçus réussis et les liens natifs. Récupérez une destination en échec via son propre point de terminaison de retry au lieu de recréer tout le lot. Préférez les webhooks signés ; en cas de polling, utilisez un nombre borné de tentatives avec des délais croissants et remontez le travail non résolu à une personne.