Rate limits

Límite

60 peticiones por minuto por IP, sobre el conjunto de /api/v1/*.

Cabeceras de respuesta

Toda respuesta (éxito o error) incluye:

Cabecera	Significado
`X-RateLimit-Limit`	Peticiones permitidas por minuto (60).
`X-RateLimit-Remaining`	Peticiones que te quedan en la ventana actual.
`X-RateLimit-Reset`	Epoch (segundos) en el que el contador vuelve a cero.

Al superar el límite

429 RATE_LIMIT_EXCEEDED. Detalle completo en /docs/errores.

{
  "status": "error",
  "code": "RATE_LIMIT_EXCEEDED",
  "message": "Límite de 60 peticiones por minuto superado."
}

Cómo agrupar en menos peticiones

En vez de pedir un registro por petición, sube count:

GET /v1/{locale}/{generator}: hasta 1000 por petición.
POST /v1/{locale}/bulk: hasta 10000 filas por petición, con varias columnas coherentes entre sí.

Para pipelines de CI/CD que generan datasets grandes, una sola llamada a bulk con count alto consume mucho menos cuota que muchas llamadas individuales — ver la guía de CI/CD.