GPSINTEGRA Mapa
—

API de consumo

Genera tokens para que un tercero consuma nuestro servicio de seguimiento. Cada token es un secreto: se muestra una sola vez.

Tokens de acceso

NombreTokenCreadoÚltimo usoEstado
Cargando…

Cómo consumir la API

Base URLhttp://localhost:3200 (local; al exponerla al exterior se reemplaza por la URL pública) AutenticaciónHeader x-api-key: <token>

1) Listar proveedores disponibles

GET {{base}}/api/proveedores
x-api-key: <token>

2) Consultar posición — el consumidor manda credenciales del portal GPS + la placa + el proveedor:

POST {{base}}/api/track
x-api-key: <token>
Content-Type: application/json

{
  "proveedor": "detektor",
  "usuario": "usuario_del_portal",
  "clave": "clave_del_portal",
  "url": "https://url-del-portal",   // opcional (los config suelen necesitarla)
  "placa": "ABC123"                    // o "placas": ["ABC123","DEF456"]
}

Respuesta

{
  "ok": true,
  "proveedor": "detektor",
  "encontradas": 1,
  "resultados": [
    { "placa": "ABC123", "latitud": 4.62, "longitud": -74.10,
      "fecha": "2026-...", "velocidad": 0, "estado": "apagado", "direccion": null }
  ]
}

También hay una colección de Postman lista en track-api.postman_collection.json (impórtala y pega el token en la variable api_key).