API y desarrollo
Rate limits
Límites de tráfico de la API de Bisturí: ventana, headers de respuesta, estrategia de backoff.
Próximamente · Q3 2026
Límite propuesto
Plan estándar: 600 requests por minuto por API key, con burst de hasta 100 requests en 1 segundo. Plan profesional o superior: 2400 requests por minuto. Para integraciones con tráfico mayor, contactanos para cotizar un plan custom.
Headers de respuesta
Cada respuesta de la API va a incluir los headers estándar X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset (timestamp UNIX). Cuando alcances el límite, recibís 429 Too Many Requests con Retry-After en segundos.
Estrategia recomendada
Backoff exponencial con jitter: ante un 429, esperá el Retry-After + un jitter aleatorio entre 0 y 1000 ms, después reintentá. Si seguís recibiendo 429, doblá la espera hasta un máximo de 60 segundos. Para batch jobs, distribuí los requests en el tiempo en vez de mandarlos todos juntos.
Excepciones
Algunos endpoints tienen límites separados más bajos: autenticación (10/min) y generación de PDF (60/min). Eso es para proteger recursos caros.