Portal de Desarrolladores de GeoTareas
Bienvenido al portal de integración de la API de GeoTareas. Esta documentación cubre la API apidev/v1 — autenticación, gestión de tareas (alta, actualización, cancelación, lectura, multimedia), gestión de flota, catálogos, geocoding, ingesta de telemetría y reportes operativos.
Todos los endpoints de este portal están incluidos en tu plan excepto la API de Geocoding — esa se cobra por uso: cada solicitud resuelta se descuenta de tu cupo de geocodificación contratado. El autocompletado, la consulta de saldo y los aciertos de caché son gratis. Mirá la página de Geocoding para el detalle del costo.
Qué está disponible
- 70 endpoints en la superficie pública de integración
- Autenticación dual: JWT + clave de API en cada solicitud protegida
- Ingesta de telemetría para dispositivos IoT/GPS
- Gestión de flota: dispositivos, conductores, posiciones (lectura y escritura)
- Gestión de tareas: alta (por lote), actualización, cancelación, listado y detalle, y adjuntos/PDF de formularios — ver Tareas
- Catálogos: 25 endpoints de consulta para resolver IDs reales (cascada geográfica, procedencias, productos, causas, OAV…) — ver Catálogos
- Geocoding (de pago, por uso): forward, reverse, autocompletado y saldo — ver Geocoding
- Mensajería a móviles: enviar un mensaje a un móvil y buscar dispositivos cercanos
- 21 endpoints de reportes: rastreo satelital AVL (9), GT Operations (5), CPM (4) y General (3)
- Legacy Despacho: capa de compatibilidad compatible con GeneXus para migrar integraciones existentes
- Límite de solicitudes centralizado con encabezados en la respuesta
- Caché Redis en todos los endpoints GET
Ruta de lectura recomendada
- Autenticación — Entendé el modelo de autenticación dual (JWT + clave de API) y el flujo de inicio de sesión.
- Quickstart — Configurá tu entorno local y ejecutá tu primera llamada a la API.
- Conceptos — Leé Manejo de errores, Límite de solicitudes, Paginación y Actualizaciones parciales.
- Referencia de la API — Explorá los endpoints por dominio: Tareas, Flota y Telemetría, Catálogos, Geocoding, Reportes.
- Colección de Postman — Importá la colección lista para usar y hacer pruebas manuales.
La API de un vistazo
| Dominio | Endpoints | Descripción |
|---|---|---|
| Autenticación | 1 | Inicio de sesión — emisión de JWT + clave de API |
| Tareas | 8 | Alta (por lote), actualización, cancelación, listado y detalle, adjuntos, PDF de formularios |
| Flota y Telemetría | 10 | Dispositivos, conductores, posiciones, ingesta GPS, mensajería a móviles, cercanos |
| Catálogos | 25 | Consultas para resolver IDs reales (geografía, procedencias, productos, causas, OAV…) |
| Geocoding (de pago) | 5 | Forward, reverse, interno, autocompletado, saldo — se cobra por uso |
| Reportes — AVL | 9 | Kilómetros, geocercas, viajes, velocidad, detenido, temperatura, mantenimiento, ignición, rendimiento |
| Reportes — GT Operations | 5 | Tareas general, alertas, ubicación en vivo, tareas rechazadas, formularios avanzados |
| Reportes — CPM | 4 | Detalle de actividad del personal móvil, resumen de trabajo, rendimiento del personal, resumen de actividad |
| Reportes — General | 3 | Mensajes de hardware, inicios de sesión, alertas generadas |
| Legacy Despacho | 6 | Servicios compatibles con GeneXus bajo apidev/legacy/* |
Principios de diseño
Este portal se actualiza junto con el desarrollo. Cada nueva funcionalidad en apidev se documenta aquí con su solicitud de Postman correspondiente. La página Cobertura de la API mantiene el inventario completo de endpoints.