Referencia
Buenas prácticas
Sugerencias concretas para que la integración sea estable en producción.
- Guarde el
job_iden su sistema. Es la única forma de rastrear un job después. - Use Idempotency-Key en producción. Te ahorra duplicados ante reintentos por red.
- Comience con keys
test. Cuando todo funcione, genera unalivey cambia el secreto. - Poll cada 5-10s, no menos. Más frecuente solo consume cuota inútilmente.
- Backoff exponencial en errores 5xx. Empiece con 1s, después 2, 4, 8. No martilles.
- Cita
X-Request-Iden cualquier reporte de soporte. Nos deja rastrear su request exacta en los logs.