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

# Developers

Documentación de la API de lectura de la plataforma GPS de Tracker International: autenticación, vehículos, historial, eventos y geocercas.

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](/devs/openapi.json) con solo las operaciones verificadas |

## Autenticación en tres pasos

1. Inicia sesión con `POST /api/login`, enviando tu correo y tu contraseña. La respuesta trae tu `user_api_hash`.
2. Guarda el hash como un secreto, igual que una contraseña: da los mismos permisos que ella.
3. Envíalo en la cabecera `user-api-hash` de cada petición. Por ejemplo: `GET /api/get_devices` lista tus vehículos.

Los detalles, con ejemplos en cURL, JavaScript, Python y PHP, están en [Autenticación](/devs/autenticacion) y en [Primeros pasos](/devs/primeros-pasos).

## Por dónde empezar

- [Primeros pasos](https://trackerintl.com/devs/primeros-pasos): De 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.
- [Autenticación](https://trackerintl.com/devs/autenticacion): Có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.
- [Referencia de la API](https://trackerintl.com/devs/referencia): Operaciones de lectura verificadas de la API de la plataforma GPS, agrupadas por tema, con parámetros, respuestas y ejemplos en cuatro lenguajes.
- [Guías](https://trackerintl.com/devs/guias): Guí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.
- [Servidor MCP](https://trackerintl.com/devs/mcp): Servidor MCP de solo lectura para que un asistente de IA consulte tu cuenta de la plataforma GPS: herramientas, instalación, seguridad y límites.
- [Usar esta documentación con IA](https://trackerintl.com/devs/ia): Có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.

## 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](/devs/referencia/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](/devs/limites).
- **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](/contacto) 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](/devs/estado-de-la-documentacion). Las reglas editoriales del sitio están en la [política editorial](/politica-editorial).

## Acceso

Necesitas un usuario de la plataforma para obtener tu `user_api_hash`. Si aún no tienes uno, [contáctanos](/contacto). Si encuentras un error en esta documentación, escribe a [info@trackerintl.com](mailto:info@trackerintl.com).