Limites de tasa

Todas las solicitudes a la API estan sujetas a limites de tasa segun tu plan.

Limites del plan gratuito

Limite	Valor
Solicitudes mensuales	10.000
Solicitudes diarias	1.000
Solicitudes por minuto (RPM)	60
API tokens	5

Headers de limite de tasa

Cada respuesta de la API incluye headers de limite de tasa:

Header	Descripcion
X-RateLimit-Limit	Maximo de solicitudes por minuto
X-RateLimit-Remaining	Solicitudes restantes en la ventana actual
X-RateLimit-Reset	Marca de tiempo Unix cuando la ventana se reinicia

Manejo de errores 429

Cuando excedes el limite de tasa, la API devuelve 429 Too Many Requests:

{
  "error": "Rate limit exceeded",
  "retryAfter": 42
}

Buenas practicas:

• Implementa backoff exponencial ante respuestas 429
• Usa el header X-RateLimit-Remaining para limitar proactivamente las solicitudes
• Almacena en cache las respuestas cuando sea posible para reducir las llamadas a la API

Headers de cuota

Cada respuesta de la API incluye headers de cuota:

Header	Descripcion
X-Quota-Limit	Cuota mensual de solicitudes
X-Quota-Remaining	Solicitudes mensuales restantes
X-Quota-Daily-Limit	Cuota diaria de solicitudes
X-Quota-Daily-Remaining	Solicitudes diarias restantes

Cuota mensual

Cuando tu cuota mensual se agota, las solicitudes devuelven 429 con un mensaje indicando la fecha de reinicio de la cuota (primer dia del mes siguiente).

Cuota diaria

Cuando tu cuota diaria se agota, las solicitudes devuelven 429 hasta el siguiente dia UTC.

Planes de pago

Planes de pago con limites superiores estaran disponibles proximamente.