Erreurs et comportement de nouvelle tentative

Les réponses non réussies utilisent cette enveloppe :

{
  "error": {
    "code": "SOME_CODE",
    "message": "Human-readable explanation",
    "issues": []
  }
}

Recommandations pour les nouvelles tentatives

Réessayez en cas d’échecs de transport.
Réessayez les écritures idempotentes avec la même Idempotency-Key.
Relisez l’état durable après un travail asynchrone au lieu de supposer que la première réponse est complète.

Considérez les échecs côté serveur comme des candidates aux nouvelles tentatives uniquement lorsque l’écriture initiale utilisait une clé d’idempotence stable.
Considérez les nouvelles URL de téléchargement d’export comme temporaires et relisez-les via GET /exports/{exportId} si nécessaire.
Si une mutation est déjà en cours ou entre en conflit avec l’état actuel, examinez le code renvoyé et ne réessayez que lorsque l’opération reste logiquement sûre.

Le SDK Node.js et la CLI fournis normalisent les erreurs en objets structurés avec :

Cela permet de faire évoluer la logique d’automatisation en toute sécurité sans analyser des chaînes en texte libre.