dmpdruckraum

Zurückziehen und Fehlercodes

Lektion 5 von 5 · ca. 2 Min.

Fehler kommen als JSON { error, code, details? }. Alle Aufrufe sind idempotent und dürfen wiederholt werden.

Schritt für Schritt

  1. Zurückziehen: POST /api/partner/requests/{partnerRef}/cancel — erlaubt aus RECEIVED oder IN_REVIEW, sonst 409 not_withdrawable.
  2. Werten Sie code aus, nicht den Text in error.
  3. Bei 429 rate_limited warten Sie die Zeit aus Retry-After ab.
  4. Bei 500 internal_error wiederholen Sie denselben Aufruf.

Fehlercodes

  • 400 invalid_json / invalid_body (details listet alle Feldfehler) / file_host_not_allowed
  • 401 unauthorized — Key fehlt, ist falsch oder der Partner ist gesperrt
  • 404 not_found — partnerRef unbekannt oder gehört einem anderen Partner
  • 409 not_withdrawable — Zurückziehen nach IN_REVIEW
  • 413 body_too_large — JSON größer als 64 KB
  • 422 file_unavailable / file_size_mismatch / file_sha256_mismatch / customer_disabled
  • 429 rate_limited — zu viele neue Aufträge pro Stunde
  • 500 internal_error — gleicher Aufruf kann wiederholt werden