Cómo funciona
1
Per-minute (rate limit)
Bucket por
api_key.id que se incrementa con INCR y expira a los 60s. Cuando excedes per_minute, devolvemos 429 con details.remaining = 0.2
Mensual (cuota)
Bucket por
user_id con clave quota:{user}:{YYYY-MM} que expira al fin de mes. Al exceder monthly_quota devolvemos 402 para que tu cliente sepa que necesita upgrade, no que reintente.Respuesta de rate limit
Recomendaciones de cliente
Backoff con jitter
Para
429, espera 200–800ms aleatorio y reintenta. Nunca reintentes un 402.Cache lecturas
El CEP de una transferencia es inmutable. Cachéalo después de la primera descarga; no vuelvas a pegarle al gateway.
Batch nocturno
Si conciliarás miles de movimientos, distribúyelos en una ventana larga en vez de ráfagas.
Plan Enterprise
Sin límite de cuota y
per_minute configurable. Contáctanos en soporte@datagora.mx.