Operación
Límites de uso
Los límites protegen la estabilidad del servicio y, sobre todo, las cuentas de tus usuarios: el banco puede bloquear una clave si recibe demasiados intentos. Si tu caso necesita límites más altos, escríbenos.
Solicitudes
| Alcance | Límite |
|---|---|
| API v1, por llave | 300 por minuto |
| API v1, por dirección IP | 600 por minuto |
| MCP, por llave | 120 por minuto |
| Widget, por dirección IP | 60 por minuto |
| Envío de credenciales en el widget, por dirección IP | 10 cada 10 minutos |
| Envío de credenciales en el widget, por link token | 5 cada 30 minutos |
Los límites usan una ventana deslizante. Al superarlos, la API responde 429 con el encabezado Retry-After (en segundos):
Respuesta
429{
"error": {
"type": "rate_limit_error",
"code": "rate_limited",
"message": "Demasiadas solicitudes. Espera un momento y vuelve a intentarlo."
}
}Otros límites
| Qué | Límite |
|---|---|
| Tamaño del cuerpo de una solicitud | 32 KB |
| Elementos por página | Hasta 100 (50 por defecto) |
| Vigencia de un link token | 30 minutos, un solo uso |
| Tiempo para ingresar un código de segundo factor | 5 minutos |
Largo de client_name | 80 caracteres |
Largo de webhook_url | 2048 caracteres |
| Tiempo de respuesta de tu webhook | 10 segundos |
| Historial en la primera conexión | Últimos 90 días |
Frecuencia de sincronización
Las conexiones activas se sincronizan solas cada 6 horas en live y cada 24 horas en test. Si una sincronización falla por un problema temporal del banco, se reintenta 2 horas después. Puedes pedir una sincronización con refresh, pero úsalo con moderación: cada sincronización abre una sesión real en el banco.
Manejar un 429
Espera lo que indica Retry-After antes de reintentar, y usa espera exponencial para los errores 5xx. Para leer muchos datos, prefiere páginas grandes (limit=100) y reacciona a los webhooks en vez de consultar en bucle.
async function conReintentos(url, opciones, intentos = 4) {
for (let i = 0; i < intentos; i++) {
const respuesta = await fetch(url, opciones);
if (respuesta.status !== 429 && respuesta.status < 500) return respuesta;
if (i === intentos - 1) return respuesta;
const espera = Number(respuesta.headers.get("Retry-After")) || 2 ** i;
await new Promise((r) => setTimeout(r, espera * 1000));
}
}
const respuesta = await conReintentos("https://api.banky.cl/v1/links", {
headers: { Authorization: `Bearer ${process.env.BANKY_SECRET_KEY}` },
});