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.