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. Le ahorra duplicados ante reintentos por red.
- Comience con keys
test. Cuando todo funcione, genere unalivey cambie el secreto. - Pase el cursor tal cual lo recibió. Es un token opaco: no lo construya, no lo edite y no lo mezcle con filtros distintos a los de la primera página.
- 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 martille.
- Cite
X-Request-Iden cualquier reporte de soporte. Nos deja rastrear su request exacta en los logs.