ConverterHQDevelopers
API v1

Idempotentie en retries

Veilig herhalen zonder dure verwerking of side effects te dupliceren.

Netwerkfouten zijn ambigu: ConverterHQ kan de request hebben geaccepteerd terwijl je client geen response kreeg. Creates en handlers moeten replay-safe zijn.

Idempotente creates

Gebruik dezelfde Idempotency-Key alleen voor dezelfde logische operatie en client_reference_id voor je eigen business-ID. Hergebruik de key nooit met een andere body.

Transportretries

Retry timeouts, resets, 429 en retryable 5xx met exponentiële backoff en jitter. Respecteer Retry-After en retry deterministische 4xx niet automatisch.

Taskretries

Een execution retry maakt een nieuwe attempt en bewaart de vorige fout. Succesvolle upstream-taken verdwijnen niet wanneer alleen een downstreamtak opnieuw moet.

Webhook-idempotentie

Controleer de signature vóór side effects en dedupliceer daarna op event_id. Reageer snel en verplaats traag werk naar je eigen queue.