Readings GPS de un vehículo (trazado, máx. 12 h)

Lecturas crudas del GPS de una placa en una ventana de tiempo, en orden
cronológico (la más antigua primero).

La ventana máxima es de 12 horas. Usa desde + hasta para un rango
exacto, o horas para las últimas N horas (por defecto 1). Si necesitas un
periodo más largo, pídelo en tramos de hasta 12 horas.

Las fechas van en ISO 8601. Si no traen zona horaria se interpretan en hora
de Colombia (-05:00).

Si metadata.truncado es true, la ventana tenía más lecturas que limite:
se devolvieron las más recientes. Acorta la ventana para obtener el resto.

Límites de uso: 30 solicitudes por minuto. Ante un 503 respeta el header
Retry-After antes de reintentar.

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

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

Ejemplos de solicitud

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Respuestas

🟢200

application/json

resultado: "OK" con las lecturas, o resultado: "NO" con el código de
error de validación (ver tabla de errores).

Bodyapplication/json

Ejemplos

Lecturas encontradasVentana de más de 12 horas

{
    "resultado": "OK",
    "datos": [
        {
            "lat": 4.6512,
            "lng": -74.0623,
            "speed": 38,
            "direction": 182,
            "ubicacion_texto": null,
            "ignition_status": "on",
            "timestamp": "2026-10-06T11:00:12.000Z",
            "timestamp_bogota": "2026-10-06 06:00:12"
        },
        {
            "lat": 4.6498,
            "lng": -74.0627,
            "speed": 41,
            "direction": 185,
            "ubicacion_texto": null,
            "ignition_status": "on",
            "timestamp": "2026-10-06T11:00:42.000Z",
            "timestamp_bogota": "2026-10-06 06:00:42"
        }
    ],
    "metadata": {
        "placa": "ABC123",
        "desde": "2026-10-06T11:00:00.000Z",
        "hasta": "2026-10-06T23:00:00.000Z",
        "desde_bogota": "2026-10-06 06:00:00",
        "hasta_bogota": "2026-10-06 18:00:00",
        "ventana_horas": 12,
        "total": 2,
        "limite": 5000,
        "truncado": false
    }
}

🟠401

🟠403

🟠429

🔴503

Readings GPS de un vehículo (trazado, máx. 12 h)

Solicitud

Ejemplos de solicitud

Respuestas