ConverterHQDevelopers
API v1

Idempotenz und Wiederholungen

Requests wiederholen, ohne teure Arbeit oder Side Effects zu duplizieren.

Netzfehler sind mehrdeutig: ConverterHQ kann einen Request akzeptiert haben, obwohl die Antwort den Client nie erreichte. Creates und Handler müssen daher replay-sicher sein.

Idempotente Creates

Senden Sie dieselbe Idempotency-Key nur für dieselbe logische Operation und setzen Sie client_reference_id für Ihre Geschäfts-ID. Derselbe Key darf nie mit verändertem Body verwendet werden.

Transport-Retries

Timeouts, Resets, 429 und retryable 5xx mit exponentiellem Backoff und Jitter wiederholen. Retry-After beachten; deterministische 4xx nicht automatisch wiederholen.

Task-Retries

Ein Execution-Retry erzeugt eine neue attempt und behält den vorherigen Fehler. Bereits erfolgreiche Upstream-Tasks werden nicht gelöscht, wenn nur ein Downstream-Zweig erneut laufen muss.

Webhook-Idempotenz

Signatur vor Side Effects prüfen und danach per event_id deduplizieren. Schnell antworten und langsame Arbeit in die eigene Queue verschieben.