Empezar
Developers
Documentación de la API de lectura de la plataforma GPS de Tracker International: autenticación, vehículos, historial, eventos y geocercas.
Estado: Parcial · Revisada el 5 de octubre de 2026
Qué se verificó y cómo: Cada operación se contrastó con la plataforma en producción por lectura del código y diff, y las respuestas se midieron con datos ficticios en un entorno de pruebas. No se ha probado con una cuenta real de producción.
Este portal documenta la API de lectura de la plataforma GPS de Tracker International: consulta vehículos, posiciones, historial de recorridos, eventos, alertas, geocercas y reportes desde tu propio software. Solo publicamos lo que verificamos, y cada página te dice qué se verificó y cómo.
Lo esencial #
| Dato | Valor |
|---|---|
| Dominio base | https://plataforma.trackerintl.com. Si tu cuenta es de un revendedor marca blanca, usa el dominio que te indique quien la administra. |
| Prefijo de las rutas | /api |
| Formato | JSON |
| Credencial | user_api_hash, en la cabecera user-api-hash |
| Referencia máquina-legible | OpenAPI 3.1 con solo las operaciones verificadas |
Autenticación en tres pasos #
- Inicia sesión con
POST /api/login, enviando tu correo y tu contraseña. La respuesta trae tuuser_api_hash. - Guarda el hash como un secreto, igual que una contraseña: da los mismos permisos que ella.
- Envíalo en la cabecera
user-api-hashde cada petición. Por ejemplo:GET /api/get_deviceslista tus vehículos.
Los detalles, con ejemplos en cURL, JavaScript, Python y PHP, están en Autenticación y en Primeros pasos.
Por dónde empezar #
- Primeros pasosDe cero a tu primera consulta: inicia sesión, lista tus vehículos, pide su última posición y trae el historial de un día, con ejemplos ejecutables. Parcial
- AutenticaciónCómo obtener tu user_api_hash, cómo enviarlo en cada petición y qué permisos concede, con ejemplos en cURL, JavaScript, Python y PHP. Parcial
- Referencia de la APIOperaciones de lectura verificadas de la API de la plataforma GPS, agrupadas por tema, con parámetros, respuestas y ejemplos en cuatro lenguajes. Verificado
- GuíasGuías de integración con lo que la API de lectura permite hoy: sincronizar con un ERP o CRM, seguir posiciones en vivo y consultar historial por periodos. Parcial
- Servidor MCPServidor MCP de solo lectura para que un asistente de IA consulte tu cuenta de la plataforma GPS: herramientas, instalación, seguridad y límites. Parcial
- Usar esta documentación con IACómo leer y citar la documentación de la API con asistentes de IA: Markdown de cada página, llms.txt, texto completo y OpenAPI. Verificado
Qué cubre hoy #
- Vehículos y última posición: listado, filtros y modo delta para sondeo.
- Historial: recorrido por tramos de conducción y parada, y posiciones GPS crudas.
- Eventos y alertas: reglas de alerta, eventos disparados y conteo por tipo.
- Geocercas y rutas planificadas: lectura, y consulta de qué geocercas contienen un punto o un vehículo.
- Reportes: tipos disponibles y plantillas guardadas.
- Cuenta: datos y permisos del usuario, conductores e historial de comandos enviados.
Qué no está documentado todavía #
- Operaciones de escritura: crear o modificar vehículos, geocercas, alertas u otros datos.
- Webhooks: no hay documentación verificada. Consulta la página de webhooks.
- SDK, colección Postman, entorno de pruebas y cuenta demo para la API.
- Límites de uso oficiales: solo publicamos los que se pudieron verificar; mira Límites.
- Referencia de sensores configurados y de servicios de mantenimiento programados: pendiente. Los valores actuales de sensores y servicios de cada vehículo sí vienen dentro de la respuesta de la lista de vehículos.
Si necesitas algo que no está aquí, escríbenos y te confirmamos el estado real.
Cómo se verifica esta documentación #
Cada página muestra su estado: Verificado, Parcial o Pendiente, la fecha de revisión y cómo se revisó. La matriz completa está en Estado de la documentación. Las reglas editoriales del sitio están en la política editorial.
Acceso #
Necesitas un usuario de la plataforma para obtener tu user_api_hash. Si aún no tienes uno, contáctanos. Si encuentras un error en esta documentación, escribe a info@trackerintl.com.