Guías
Rate limits
Límites de uso de la API de Inspow.
Para proteger el servicio, la API aplica límites de tasa (rate limiting).
Límites
Sección titulada «Límites»| Límite | Valor por defecto | Se cuenta por |
|---|---|---|
| General (todos los endpoints) | 100 peticiones por minuto | Usuario autenticado (token JWT); sin token, por IP. |
| Autenticación (login, verificación de correo, recuperación de contraseña, 2FA…) | 5 peticiones por minuto | Igual que el general. |
| Por API Key | El que se fijó al crear la clave: entre 1 y 10.000 peticiones por hora (por defecto 1.000) | Cada API Key. |
Qué pasa si superas un límite
Sección titulada «Qué pasa si superas un límite»- Límite general o de autenticación: recibes
429 Too Many Requests(códigoRATE_LIMIT_EXCEEDED). Espera unos segundos y reintenta con backoff exponencial. - Límite por hora de una API Key: la petición se rechaza con
403y el mensaje «Rate limit excedido» hasta que corra la hora. Ver API Keys.
Buenas prácticas
Sección titulada «Buenas prácticas»- Cachea respuestas que no cambian con frecuencia.
- Evita polling agresivo; usa paginación y filtros por fecha.
- Para cargas grandes, distribuye las peticiones en el tiempo.
- Para integraciones, usa una API Key con un límite acorde a tu volumen.