KuidaDesarrolladores

Conceptos

Límites

Los límites protegen a todas las instituciones que usan Kuida. Son amplios para una integración normal.

Pedidos por clave
Valor600 por minuto
Al superarlo429 rate_limited
Tamaño del cuerpo
Valor1 MB
Al superarlo413 body_too_large
Eventos por lote en POST /v1/events
Valor100
Al superarlo413 batch_too_large
limit de una lista
Valor100
Al superarlo400 parameter_invalid
Vigencia de una Idempotency-Key
Valor24 horas
Al superarloLa clave se puede volver a usar
Respuesta de un webhook
Valor10 segundos
Al superarloEl intento cuenta como fallido y se reintenta

Pedidos por minuto

El límite es por clave de API, en ventanas fijas de un minuto. Las respuestas autenticadas informan el estado con tres headers:

Headers de la respuesta
RateLimit-Limit: 600
RateLimit-Remaining: 587
RateLimit-Reset: 23
RateLimit-Limit
SignificadoPedidos permitidos por minuto.
RateLimit-Remaining
SignificadoPedidos que quedan en la ventana actual.
RateLimit-Reset
SignificadoSegundos hasta que empieza la ventana siguiente.

Al superar el límite, la respuesta 429 trae Retry-After con los segundos a esperar. Los SDKs lo respetan y reintentan solos.

Cargas masivas

Para cargar muchos objetos de una vez, por ejemplo al empezar una integración, conviene POST /v1/events con lotes de hasta 100 eventos: cada lote cuenta como un solo pedido. Cada evento del lote se procesa por separado y trae su propio resultado.