Buenas prácticas

Lo que hace durar la integración.

• Use el modo incremental (desde + depoisDe) para sincronizar: trae solo lo que cambió y no derriba el límite.
• Trate 429 esperando el Retry-After, con retroceso exponencial — nunca repita en bucle cerrado.
• Envíe Idempotency-Key en todo POST: la red cae, su rutina repite, y nada se duplica.
• Verifique la firma del webhook antes de procesar; responda 2xx rápido y procese después.
• Una clave por sistema integrado, con el menor alcance que sirva; revoque la que no se usa.

Formas inadecuadas

• Recorrer la lista entera cada minuto — es lo que el modo incremental reemplaza.
• Compartir la clave de API con usuarios finales o incrustarla en app móvil o página pública.
• Grabar vía API sin usuario responsable en la clave — la traza quedaría sin autoría, por eso es 409.