#Rate limits
La API aplica límites por API key para proteger la plataforma y repartir la capacidad de forma justa.
#Límites
| Tipo de operación | Límite |
|---|---|
Lecturas (GET) | 120 peticiones por minuto. |
Escrituras (POST, PUT, PATCH, DELETE) | 30 peticiones por minuto. |
Los límites son por API key. Si necesitas más capacidad para una integración de alto volumen, contáctanos desde el Panel.
#Headers de rate limit
Cada respuesta incluye el estado de tu ventana actual:
| Header | Descripción |
|---|---|
RateLimit-Limit | Máximo de peticiones en la ventana. |
RateLimit-Remaining | Peticiones restantes en la ventana actual. |
RateLimit-Reset | Segundos hasta que la ventana se reinicia. |
#Cuando excedes el límite
La API responde 429 con error.code = rate_limited e incluye un header Retry-After con los segundos a esperar.
JSON
{
"error": {
"code": "rate_limited",
"message": "Superaste el límite de peticiones. Reintenta en 12 segundos."
}
}