rate_limit_per_minute, rate_limit_per_day). Al excederlos, Clausum devuelve 429 Too Many Requests con código RATE_LIMIT_EXCEEDED.
Valores por defecto (claves secret nuevas)
Las claves publishable e ingest pueden usar defaults más bajos. Ajusta por clave en Conexiones → Claves API al crear o editar una clave secret.
Los límites son por clave API. Usa claves separadas para checkout vs jobs batch para que picos no se throttleen entre sí.
Aplicación en producción
En producción, los límites de tasa usan Upstash Redis (UPSTASH_REDIS_REST_URL + UPSTASH_REDIS_REST_TOKEN) para conteo distribuido entre instancias Vercel. Sin Upstash en producción, Clausum falla cerrado en checks de rate limit — asegura Redis configurado antes del go-live.
Sandbox / desarrollo puede usar fallback en memoria cuando Upstash no está definido.
Headers de respuesta
Manejo de 429
Consejos
Assess una vez por decisión
Assess una vez por decisión
Llama assess al enviar checkout o autorizar payout — no en cada tecla. Usa el SDK para navegador solo para señales de dispositivo.
Reintentos idempotentes
Reintentos idempotentes
Los reintentos tras timeout deben reutilizar el mismo
order_id o Idempotency-Key — no cuentan doble contra velocidad como lo harían órdenes duplicadas.Solicitar límites más altos
Solicitar límites más altos
¿Alto volumen en producción? Contacta api@clausum.ai antes del lanzamiento.