Stream SSE de posición en vivo (push)

Server-Sent Events: empuja la posición del vehículo en tiempo real,
sin polling. Al conectar envía un evento snapshot con el último lite;
después un evento loc por cada nueva posición. Incluye heartbeats
(comentarios :\n\n) cada ~20 s y una directiva retry: con jitter
(evita tormentas de reconexión).

Auth

watch-token (JWT HS256, scope: watch, scoped a ESA placa, exp ~15 min),
pasado por query ?token= (EventSource no puede setear headers) o por
header Authorization: Bearer. Un admin token también es aceptado. El
watch-token lo emite backend-app en GET /api/v1/gps/watch-token/:placa.

Formato de eventos (`text/event-stream`)

retry: 3500

event: snapshot
data: {"placa":"PUP074","ts":1780970872000,"lat":3.440298,"lng":-76.500808,"spd":9,"hdg":64,"mode":"device_only","src":"zonar","acc":10}

event: loc
data: {"placa":"PUP074","ts":1780970890000,"lat":3.441010,"lng":-76.501200,"spd":10,"hdg":63,"mode":"device_only","src":"zonar","acc":10}

Cada data: es un objeto CanonLite serializado.

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Respuestas

🟢200OK

text/event-stream

Stream SSE abierto. Eventos snapshot (inicial) y loc (por update); data = CanonLite.

Bodytext/event-stream

Ejemplo

retry: 3500

event: snapshot
data: {"placa":"PUP074","ts":1780970872000,"lat":3.440298,"lng":-76.500808,"spd":9,"hdg":64,"mode":"device_only","src":"zonar","acc":10}

event: loc
data: {"placa":"PUP074","ts":1780970890000,"lat":3.441010,"lng":-76.501200,"spd":10,"hdg":63,"mode":"device_only","src":"zonar","acc":10}

🟠400Petición incorrecta

🟠401No autorizado

🟠429

🔴503Servicio no disponible

Stream SSE de posición en vivo (push)

Auth

Formato de eventos (`text/event-stream`)

Solicitud

Ejemplos de solicitud

Respuestas

Stream SSE de posición en vivo (push)

Auth#

Formato de eventos (text/event-stream)#

Solicitud

Ejemplos de solicitud

Respuestas

Auth

Formato de eventos (`text/event-stream`)