ConverterHQDevelopers
API v1

Idempotencia y reintentos

Reintenta sin duplicar trabajo costoso ni efectos secundarios.

Un fallo de red es ambiguo: ConverterHQ puede aceptar la petición aunque el cliente no reciba la respuesta. Diseña creaciones y handlers para replay seguro.

Creaciones idempotentes

Usa la misma Idempotency-Key solo para la misma operación lógica y client_reference_id para tu ID de negocio. Nunca reutilices una key con un body diferente.

Reintentos de transporte

Reintenta timeouts, resets, 429 y 5xx retryable con backoff exponencial y jitter. Respeta Retry-After; no repitas 4xx deterministas automáticamente.

Reintentos de Tasks

Un retry de ejecución crea una nueva attempt y conserva el fallo anterior. El trabajo upstream ya correcto no desaparece si solo hay que repetir una rama downstream.

Idempotencia de webhooks

Verifica la firma antes del efecto y deduplica por event_id. Responde rápido y envía trabajo lento a tu propia cola.