Saltar al contenido

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

AlcanceLímite
API v1, por llave300 por minuto
API v1, por dirección IP600 por minuto
MCP, por llave120 por minuto
Widget, por dirección IP60 por minuto
Envío de credenciales en el widget, por dirección IP10 cada 10 minutos
Envío de credenciales en el widget, por link token5 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 solicitud32 KB
Elementos por páginaHasta 100 (50 por defecto)
Vigencia de un link token30 minutos, un solo uso
Tiempo para ingresar un código de segundo factor5 minutos
Largo de client_name80 caracteres
Largo de webhook_url2048 caracteres
Tiempo de respuesta de tu webhook10 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}` },
});