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