Fehler und Wiederholungsverhalten

Antworten ohne Erfolg verwenden diese Hülle:

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

Hinweise zum Wiederholen

Wiederhole Transportfehler.
Wiederhole idempotente Schreiboperationen mit demselben Idempotency-Key.
Lies den dauerhaften Zustand nach asynchroner Arbeit erneut, statt anzunehmen, dass die erste Antwort vollständig ist.

Betrachte serverseitige Fehler nur dann als Kandidaten für Wiederholungen, wenn der ursprüngliche Schreibvorgang einen stabilen Idempotency-Key verwendet hat.
Betrachte neue Export-Download-URLs als temporär und lies sie bei Bedarf erneut aus GET /exports/{exportId}.
Wenn eine Mutation bereits läuft oder mit dem aktuellen Zustand kollidiert, prüfe den zurückgegebenen code und wiederhole nur, wenn die Operation weiterhin logisch sicher ist.

Das mitgelieferte Node.js SDK und die CLI normalisieren Fehler zu strukturierten Objekten mit:

Das macht es sicher, Automatisierungslogik zu verzweigen, ohne frei formulierte Strings parsen zu müssen.