API para desarrolladores

API REST para integrar el rastreo YAGPS a tu sistema. Ideal para aseguradoras y flotas que quieren consultar equipos, posiciones y alertas desde su propia plataforma.

Autenticación

Cada request se autentica con una API key que generás desde tu panel (detalle de tu cuenta → Integraciones). Enviala en el header X-API-Key o como Bearer token. Todo queda scopeado a tu cuenta: nunca ves datos de otros clientes.

curl https://api.yagps.app/v1/devices \
  -H "X-API-Key: TU_API_KEY"

# alternativa:
curl https://api.yagps.app/v1/devices \
  -H "Authorization: Bearer TU_API_KEY"

Endpoints

GET

/v1/devices

Lista todos tus equipos (id, nombre, uniqueId, tipo, estado de corte).

GET

/v1/devices/:id/position

Última posición conocida de un equipo (lat, lon, velocidad, atributos).

GET

/v1/alerts?limit=50

Últimas alertas de tu cuenta (robo, zona, velocidad, SOS…).

Ejemplo — listar equipos

GET /v1/devices
{
  "data": [
    {
      "id": "clx...",
      "name": "Equipo 1",
      "uniqueId": "SW-A1B2C3D4",
      "kind": "LAPTOP",
      "model": "Agente YAGPS",
      "immobilized": false,
      "createdAt": "2026-07-10T18:00:00.000Z"
    }
  ]
}

Ejemplo — posición en vivo

GET /v1/devices/clx.../position
{
  "data": {
    "deviceId": "clx...",
    "latitude": -34.6037,
    "longitude": -58.3816,
    "speedKmh": 0,
    "attributes": { "battery": 87, "ignition": true }
  }
}

Webhooks

Además del pull por API, podés registrar un webhook en tu panel para recibir cada evento en tiempo real (POST firmado con HMAC en el header X-YAGPS-Signature). Ideal para automatizar el aviso de robo dentro de tu sistema de siniestros.

¿Integración para tu aseguradora?

Te damos un entorno de prueba y acompañamiento técnico.

Hablar con el equipo técnico