Conceptos
Límites
Qué límites de uso se conocen de la API (intentos de login, geocercas, rango de historial, tamaño de página) y cuáles no están confirmados.
Estado: Parcial · Revisada el 5 de octubre de 2026
Qué se verificó y cómo: Valores leídos del código de la plataforma y contrastados con producción por diff. No se leyó la configuración de producción, así que cada cifra es el valor por defecto del código, no una medición.
Esta página solo publica los límites que se pudieron verificar. Los valores de producción pueden diferir de los valores por defecto del código; donde lo sabemos, lo decimos.
Límites de peticiones #
| Operación | Límite | Estado |
|---|---|---|
POST /api/login | 60 peticiones por minuto | Valor por defecto del código; el de producción no está confirmado |
GET /api/point_in_geofences | 30 peticiones por minuto | Medido en un entorno de pruebas |
GET /api/devices_in_geofences | 1800 peticiones por minuto | Leído del código |
| Resto de operaciones | Sin límite global en el código | Un proxy o una capa de red delante de la plataforma podría añadir límites que no se verificaron |
Cuando superes un límite, espera y reintenta con espera creciente. No publicamos todavía un límite global ni una frecuencia de sondeo recomendada.
Límites de datos #
| Qué | Límite | Estado |
|---|---|---|
Rango de get_history | 31 días | Valor por defecto; el de producción no está confirmado. Si lo superas, la API responde 422 |
Rango de get_history_messages | Sin límite en el código | Consulta por tramos de hasta 31 días, como en get_history |
limit de get_history_messages | 50, 100, 200, 300, 400, 500 o 1000 | Verificado; otro valor se sustituye por 50 sin avisar |
limit de get_events | 1000 como máximo; 30 por defecto | Verificado |
limit de get_devices | Sin tope en el código | Se recomienda no pasar de 200 |
| Tamaño de página fijo | get_routes 500; sent_commands 15 | Verificado |
Tamaño de get_reports_types | Unos 128 KB en una cuenta de pruebas | Medido; depende de la cuenta |
Qué no sabemos todavía #
- Cuántos días de historial se conservan.
- Si existe una cuota diaria o mensual por plan.
- Qué límites añade la infraestructura que está delante de la plataforma.
- La frecuencia máxima recomendada de sondeo.
Cuando tengamos mediciones reales de producción, las publicaremos aquí con su fecha.