Aesesdocs

Rate limits

Aeses aplica rate limits por clave para proteger la plataforma y garantizar un uso justo. Los límites se aplican de forma independiente a claves de prueba y live.

Límites por defecto

| Plan | Lectura (GET) | Escritura (POST/DELETE) | | ---------- | --------------- | --------------------------- | | Standard | 100 req/s | 25 req/s | | Scale | 500 req/s | 100 req/s | | Enterprise | Personalizado | Personalizado |

Se toleran ráfagas de hasta 2× el límite sostenido durante ventanas cortas.

Inspeccionar tus límites

Cada respuesta incluye estos headers:

| Header | Descripción | | ----------------------- | ----------------------------------------------------------------- | | X-RateLimit-Limit | Máximo de solicitudes permitidas en la ventana actual. | | X-RateLimit-Remaining | Solicitudes restantes en la ventana actual. | | X-RateLimit-Reset | Timestamp Unix (segundos) en que la ventana se reinicia. | | Retry-After | Presente en respuestas 429. Segundos a esperar antes del retry. |

Al alcanzar el límite

Cuando excedes el límite, Aeses responde con 429 rate_limit_error:

Respuesta de rate-limit
{
"error": {
  "type": "rate_limit_error",
  "code": "rate_limited",
  "message": "Too many requests. Retry after 1.2 seconds.",
  "request_id": "req_01HXYZ..."
}
}

La respuesta incluye un header Retry-After. Espera al menos esa duración antes de reintentar. Combínalo con backoff exponencial para evitar retries en manada en un pico puntual.

Diseñando alrededor de los límites

  • Agrupa cuando puedas. Usa los endpoints de listado con limit=100 en lugar de hacer polling de recursos individuales.
  • Suscríbete, no hagas polling. Escucha webhooks en lugar de sondear el estado de deposit/withdrawal.
  • Cachea lecturas. Los datos de saldo y cuenta cambian poco — cachéalos al menos 10 segundos.
  • Claves separadas por workload. Usa claves distintas para tráfico síncrono de cara al usuario y para reconciliación en background, evitando que un job pesado le quite ancho de banda al checkout.

Si alcanzas el límite con frecuencia, solicita un aumento desde Panel → Developers → Plan limits.