> Índice completo de la documentación: https://trackerintl.com/devs/llms.txt
> Esta página en HTML: https://trackerintl.com/devs/limites
> Estado: Parcial, revisada el 2026-10-05. 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.

# 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.

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.