Limites de Tasa

Los limites de tasa protegen la API contra abuso y aseguran un uso justo para todos los clientes. Los limites varian segun el plan.

Limites por Plan

Cada respuesta de la API incluye informacion de limite de tasa en los headers:

Header	Descripcion
`X-RateLimit-Limit`	Solicitudes maximas por minuto para tu plan
`X-RateLimit-Remaining`	Solicitudes restantes en la ventana actual
`X-RateLimit-Reset`	Marca de tiempo Unix cuando el limite de tasa se reinicia

Cuando excedes el limite de tasa, la API devuelve una respuesta 429 Too Many Requests. Para manejarlo correctamente:

429 Too Many Requests

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 30 seconds."
  }
}

Plan

Solicitudes/min

Creditos/mes

Free

1,000

Pay As You Go

Segun compra

Project

7,000

Bootstrap

28,000

Startup

85,000

Growth

200,000

Header

Descripcion

X-RateLimit-Limit

Solicitudes maximas por minuto para tu plan

X-RateLimit-Remaining

Solicitudes restantes en la ventana actual

X-RateLimit-Reset

Marca de tiempo Unix cuando el limite de tasa se reinicia

Manejo de Errores 429

Cuando excedes el limite de tasa, la API devuelve una respuesta 429 Too Many Requests. Para manejarlo correctamente:

Verifica el header X-RateLimit-Reset para saber cuando puedes reintentar

Implementa retroceso exponencial en tu logica de reintentos

Encola solicitudes para mantenerte dentro de tu limite por minuto

Considera mejorar tu plan si alcanzas los limites constantemente

429 Too Many Requests

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 30 seconds."
  }
}