Integra la posición en tiempo real, el historial de recorridos y las alarmas de tus unidades a tu ERP, BI o TMS — con una API simple, segura y de solo lectura.
Para quién
Si tu equipo ya tiene ERP, dashboards o sistemas de control, tiene más sentido alimentar esos sistemas con nuestros datos que pedirle a tu gente entrar a otra plataforma.
SAP, Oracle, Odoo o desarrollo propio que quieren ver la flota dentro de su sistema de gestión.
Empresas que coordinan transportistas tercerizados y necesitan visibilidad unificada en su plataforma.
Plataformas oficiales (SUTRAN, OSINERGMIN, SIPCOP) o auditores que requieren un flujo continuo de datos.
Paso 1
Por seguridad, las claves las emite nuestro equipo para tu cuenta. El proceso toma minutos.
Envía un correo a [email protected] con tu empresa, tu usuario en la plataforma y para qué usarás la API.
Generamos una clave X-API-Key acotada a tu cuenta, con los permisos que necesites.
Recibes tu clave + la lista de tus IMEIs. La pones en el header de cada petición y listo.
Escríbenos a [email protected] — indícanos si la quieres de pruebas (sandbox) o de producción.
Manual · Producción
API REST. Todas las peticiones son GET y responden JSON con la forma {"code":0,"data":…} — code:0 = éxito.
https://global.globalgpsperu.com/open/v1
Header X-API-Key: gpp_… en cada petición. Nunca en la URL.
# header en toda petición curl -sS 'https://global.globalgpsperu.com/open/v1/track?imeis=IMEI' \ -H 'X-API-Key: gpp_TU_CLAVE'
Posición y telemetría actual de una o varias unidades.
| Parámetro | Tipo | Descripción |
|---|---|---|
imeis requerido | string | IMEIs separados por coma (hasta 100). |
curl -sS '…/open/v1/track?imeis=990000000000001' \ -H 'X-API-Key: gpp_TU_CLAVE'
{
"code": 0,
"data": [{
"imei": "990000000000001",
"name": "Camioneta 1 (demo)", // nombre de la unidad
"plate": "DEMO-CM1", // placa
"servertime": 1785459742, "gpstime": 1785459742,
"hearttime": 1785459742, "systemtime": 1785459755,
"latitude": -8.06730, "longitude": -79.05071,
"speed": 75.0, "course": 162,
"accstatus": 1, // motor 1=on 0=off
"acctime": 170721, // seg. del motor en ese estado
"datastatus": 1, // 1=en línea 0=offline
"doorstatus": 0, "chargestatus": 1,
"oilpowerstatus": 0, "defencestatus": 0,
"battery": 100, // batería %
"mileage": 786938.3, // odómetro km
"todaymileage": 75.14 // km de hoy
}]
}Historial de recorrido de una unidad. Máximo 31 días por consulta.
| Parámetro | Tipo | Descripción |
|---|---|---|
imei requerido | string | Una unidad. |
begintime requerido | epoch/ISO | Inicio (epoch seg. o 2026-07-28T00:00:00Z). |
endtime requerido | epoch/ISO | Fin. Rango máx. 31 días. |
curl -sS '…/open/v1/playback?imei=…&begintime=…&endtime=…' \ -H 'X-API-Key: gpp_TU_CLAVE'
{ "code": 0, "data": [
{ "latitude": -12.104, "longitude": -77.038,
"gpstime": 1785290400, "speed": 32, "course": 210, "accstatus": 1 }
// … hasta 50 000 puntos por consulta
]}Alarmas de la flota. Sin fechas devuelve las de hoy.
| Parámetro | Tipo | Descripción |
|---|---|---|
imeis opcional | string | Filtra por unidades. Vacío = toda la flota. |
begintime opcional | epoch/ISO | Def.: hoy 00:00. |
endtime opcional | epoch/ISO | Def.: ahora. |
curl -sS '…/open/v1/alarms' \ -H 'X-API-Key: gpp_TU_CLAVE'
{ "code": 0, "data": [{
"imei": "990000000000001", "alarmtype": 1, "tipo": "exceso_velocidad",
"latitude": -12.10, "longitude": -77.03,
"speed": 68, "course": 154,
"gpstime": 1785292023, "systemtime": 1785292025,
"geofenceid": 0, "geofencename": "" // solo alarmas de geocerca
}]}Códigos de alarma
60 peticiones por minuto por clave. Cada acceso queda auditado.
Solo lectura: la API no envía comandos ni corta motor. Alcance: solo tus unidades.
Pruebas · Sandbox
Prueba tu integración sin tocar tus equipos reales. Te damos una clave sobre una cuenta demo con unidades simuladas que se mueven por Lima en tiempo real, 24/7 — con posición, combustible, alarmas y video.
A [email protected], indicando "sandbox". Te enviamos la clave demo + los IMEIs de prueba.
Las unidades demo se mueven de verdad — /track, /playback y /alarms responden datos reales al instante.
IMEIs de prueba disponibles
Con tu clave de pruebas, consulta una unidad demo — devuelve su posición en vivo.
curl -sS '…/open/v1/track?imeis=990000000000001' \ -H 'X-API-Key: gpp_TU_CLAVE_DEMO' # → posición viva de la unidad demo (se mueve por Lima 24/7)
A [email protected] con el asunto "Sandbox".
En producción
Integraciones B2B activas. Si tu cliente o regulador exige una nueva, la implementamos a medida.
Plataforma de gestión de transporte para distribuidoras y operadores logísticos B2B.
Integración OAuth Azure (Grupo Gerdau) para los transportistas de su cadena.
Carga marítima y transporte multimodal con protocolo dedicado al operador.
Movilidad urbana, taxis y transporte privado con plataforma propia.
Integraciones a medida
La API estándar es de solo lectura (posición, historial y alarmas) con clave X-API-Key — lo de arriba. Todo lo demás lo desarrollamos a tu medida:
En vez de consultar, te avisamos por HTTP cuando ocurre un evento (entrada/salida de geocerca, SOS, jamming).
Autenticación federada (p. ej. OAuth Azure, como SiderPerú) para tu entorno corporativo.
Acciones como corte de motor, con permisos y trazabilidad — bajo acuerdo.
Campos y formato a la medida de SAP, Oracle, Odoo o tu desarrollo propio.
Cómo trabajamos
Conversamos con tu TI: qué datos, a qué sistema, con qué frecuencia.
Alcance técnico, plazos y modelo comercial. NDA si lo necesitas.
Credenciales de prueba; tu equipo desarrolla sin afectar producción.
Pasamos a prod coordinados, con soporte dedicado el primer mes.
En 24 h hábiles te respondemos con el alcance técnico y el plazo. Nueva integración en menos de 3 días hábiles para flotas contratadas de 3 unidades a más.