{"info":{"_postman_id":"049ed913-9646-43a5-b148-7cca6a6cfee1","name":"API Velocidad","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"description":"<html><head></head><body></body></html>","owner":"50892995","collectionId":"049ed913-9646-43a5-b148-7cca6a6cfee1","publishedId":"2sBYHNVhKM","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-09-30T19:14:56.000Z"},"item":[{"name":"Obtener token","event":[{"listen":"test","script":{"exec":["const jsonData = pm.response.json();","const wpsid = pm.response.headers.get(\"wpsid\");","pm.environment.set(\"token\", jsonData.AuthenticationResult.AccessToken);","pm.environment.set(\"wpsid\", wpsid);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"5ff3063f-3e2d-4425-bf59-00699c69c860","request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n    \"user\": \"user\",\r\n    \"password\": \"password1\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.waypoint.cl/auth/login","description":"<h3 id=\"paso-1\">Paso 1</h3>\n<p>Se debe realizar una consulta POST a la API de sesiones para obtener el AccesToken que usaremos en el paso 2 para consumir la api de velocidad.</p>\n","urlObject":{"protocol":"https","path":["auth","login"],"host":["api","waypoint","cl"],"query":[],"variable":[]}},"response":[],"_postman_id":"5ff3063f-3e2d-4425-bf59-00699c69c860"},{"name":"Generar reporte","id":"ecb98874-c704-4c98-9445-9d24e69b5340","request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"timezoneId\": \"America/Santiago\",\n    \"fechaDesdeStr\": \"2026-09-30 00:00:00\",\n    \"fechaHastaStr\": \"2026-09-30 23:59:50\",\n    \"clientId\": 9999,\n    \"velocidadMaximaPermitida\": 120,\n    \"umbralTolerancia\": 0,\n    \"multiSheet\": false,\n    \"referencia\": false,\n    \"nsat\": 3,\n    \"hdop\": 4,\n    \"formato\": \"JSON\"\n}","options":{"raw":{"language":"json"}}},"url":"https://reportes.waypoint.cl/v1/base/velocidad","description":"<h3 id=\"paso-2\">Paso 2</h3>\n<p>Se debe realizar una consulta de tipo POST y debemos agregar el token obtenido en el paso 1 en la pestaña Authorization, de tipo Bearer Token.</p>\n<p>Finalmente agregamos el body, apretamos send y la respuesta que nos dé (id y nombreReporte) la copiaremos para usarla en el paso 3.</p>\n<p>El reporte entrega todos los tramos en que los vehículos del cliente superaron la velocidad máxima indicada, dentro del rango de fechas solicitado.</p>\n<h3 id=\"detalle-de-los-valores-del-body\">Detalle de los valores del Body</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Campo</th>\n<th>Valor de ejemplo</th>\n<th>¿Obligatorio?</th>\n<th>Significado</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>timezoneId</td>\n<td>America/Santiago</td>\n<td>Sí</td>\n<td>Zona horaria en que se interpretan las fechas desde y hasta. Ej: America/Santiago, America/Mexico_City, America/Lima.</td>\n</tr>\n<tr>\n<td>fechaDesdeStr</td>\n<td>2026-09-30 00:00:00</td>\n<td>Sí</td>\n<td>Fecha y hora de inicio del reporte, en formato AAAA-MM-DD HH:MM:SS.</td>\n</tr>\n<tr>\n<td>fechaHastaStr</td>\n<td>2026-09-30 23:59:50</td>\n<td>Sí</td>\n<td>Fecha y hora de fin del reporte, en formato AAAA-MM-DD HH:MM:SS.</td>\n</tr>\n<tr>\n<td>clientId</td>\n<td>9999</td>\n<td>Sí</td>\n<td>ID del tenant a solicitar. Se incluyen todos los vehículos del cliente.</td>\n</tr>\n<tr>\n<td>velocidadMaximaPermitida</td>\n<td>120</td>\n<td>Sí</td>\n<td>Velocidad máxima permitida en km/h. Todo registro por sobre este valor, con la ignición encendida, se considera exceso.</td>\n</tr>\n<tr>\n<td>hdop</td>\n<td>4 (recomendado)</td>\n<td>Sí</td>\n<td>Máximo valor HDOP permitido. Se descartan los registros GPS con un HDOP mayor (menor precisión).</td>\n</tr>\n<tr>\n<td>formato</td>\n<td>JSON</td>\n<td>Sí</td>\n<td>Formato de salida del reporte, \"JSON\" o \"XLS\" (Excel). Debe ir en mayúsculas.</td>\n</tr>\n<tr>\n<td>nsat</td>\n<td>3 (recomendado)</td>\n<td>No</td>\n<td>Mínimo número de satélites. Se descartan los registros GPS con menos satélites. Si no se envía, no se filtra por satélites.</td>\n</tr>\n<tr>\n<td>umbralTolerancia</td>\n<td>0</td>\n<td>No</td>\n<td>Duración mínima, en segundos, que debe tener un exceso para aparecer en el reporte. Ej: 10 descarta los excesos de menos de 10 segundos. Por defecto es 0: se incluyen todos.</td>\n</tr>\n<tr>\n<td>referencia</td>\n<td>false</td>\n<td>No</td>\n<td>referencia = true indica, para cada exceso, la zona del cliente donde comenzó y donde terminó. Debe estar creada la zona en la plataforma. Por defecto va en false.</td>\n</tr>\n<tr>\n<td>multiSheet</td>\n<td>false</td>\n<td>No</td>\n<td>Solo aplica al formato XLS. multiSheet = true genera una hoja por vehículo; multiSheet = false deja todos los vehículos en una misma hoja. Por defecto va en false.</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["v1","base","velocidad"],"host":["reportes","waypoint","cl"],"query":[],"variable":[]}},"response":[],"_postman_id":"ecb98874-c704-4c98-9445-9d24e69b5340"},{"name":"Status y archivo","id":"56f54721-285a-4c57-aa9c-0b762f1ad634","request":{"method":"POST","header":[{"key":"x-api-key","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"id\": \"c57a4f15-ee29-4ab3-a0b9-a34e3f784a77\",\n    \"nombreReporte\": \"ReporteVelocidad101StateMachine\",\n    \"count\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://reportes.waypoint.cl/v1/base/report-status","description":"<h3 id=\"paso-3\">Paso 3</h3>\n<p>Se debe realizar una consulta de tipo POST, agregando en el header la x-api-key, y en el Body la respuesta del paso 2 más un atributo \"count\": true.</p>\n<p>Mientras el reporte se está generando, el status será RUNNING: se debe volver a consultar después de unos segundos. Cuando la petición esté lista, el status será SUCCEEDED (200) y nos mostrará una url, la cual tendrá un archivo con la data solicitada.</p>\n<h3 id=\"detalle-de-los-valores-del-body\">Detalle de los valores del Body</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Campo</th>\n<th>Valor de ejemplo</th>\n<th>Significado</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>c57a4f15-ee29-4ab3-a0b9-a34e3f784a77</td>\n<td>ID del reporte (obtenido en la respuesta del paso 2).</td>\n</tr>\n<tr>\n<td>nombreReporte</td>\n<td>ReporteVelocidad101StateMachine</td>\n<td>Nombre del reporte (obtenido en la respuesta del paso 2).</td>\n</tr>\n<tr>\n<td>count</td>\n<td>true</td>\n<td>Atributo adicional para la consulta, debe ser True.</td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"detalle-de-la-respuesta\">Detalle de la respuesta</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Variable</th>\n<th>Significado</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>ID del reporte consultado.</td>\n</tr>\n<tr>\n<td>status</td>\n<td>Estado del reporte: RUNNING (en proceso), SUCCEEDED (listo), FAILED (falló, se debe volver a solicitar).</td>\n</tr>\n<tr>\n<td>count</td>\n<td>Cantidad de grupos de vehículos ya procesados.</td>\n</tr>\n<tr>\n<td>total</td>\n<td>Cantidad total de grupos de vehículos a procesar.</td>\n</tr>\n<tr>\n<td>url</td>\n<td>Link de descarga del archivo. Solo aparece cuando el status es SUCCEEDED.</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"respuesta-de-la-api-formato-json\">Respuesta de la API (formato JSON)</h2>\n<p>El archivo descargado contiene un arreglo con un elemento por cada exceso de velocidad (tramo) encontrado. Si ningún vehículo superó la velocidad máxima, el arreglo viene vacío.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Variable</th>\n<th>Significado</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>vehiculoPatente</td>\n<td>Placa/Patente del vehículo.</td>\n</tr>\n<tr>\n<td>vehiculoGrupo</td>\n<td>Grupo al que pertenece el vehículo en la plataforma.</td>\n</tr>\n<tr>\n<td>vehiculoClase</td>\n<td>Tipo de vehículo registrado en la plataforma.</td>\n</tr>\n<tr>\n<td>vehiculoDescripcion</td>\n<td>Descripción del vehículo registrada en la plataforma.</td>\n</tr>\n<tr>\n<td>conductor</td>\n<td>Nombre del conductor registrado en la plataforma durante el exceso.</td>\n</tr>\n<tr>\n<td>origenData</td>\n<td>Fuente del dato: \"GPS\" o \"OBDII\" (telemetría del vehículo).</td>\n</tr>\n<tr>\n<td>desde</td>\n<td>Fecha de inicio del exceso en formato epoch (milisegundos).</td>\n</tr>\n<tr>\n<td>hasta</td>\n<td>Fecha de término del exceso en formato epoch (milisegundos).</td>\n</tr>\n<tr>\n<td>tiempo</td>\n<td>Duración del exceso en milisegundos.</td>\n</tr>\n<tr>\n<td>distancia</td>\n<td>Distancia recorrida durante el exceso, en kilómetros.</td>\n</tr>\n<tr>\n<td>promedio</td>\n<td>Velocidad promedio durante el exceso, en km/h.</td>\n</tr>\n<tr>\n<td>minima</td>\n<td>Velocidad mínima durante el exceso, en km/h.</td>\n</tr>\n<tr>\n<td>maxima</td>\n<td>Velocidad máxima durante el exceso, en km/h.</td>\n</tr>\n<tr>\n<td>registros</td>\n<td>Cantidad de registros GPS que componen el exceso.</td>\n</tr>\n<tr>\n<td>latitud</td>\n<td>Latitud de la posición donde comenzó el exceso.</td>\n</tr>\n<tr>\n<td>longitud</td>\n<td>Longitud de la posición donde comenzó el exceso.</td>\n</tr>\n<tr>\n<td>catidadSatelites</td>\n<td>Número de satélites del registro GPS. A mayor, mejor calidad.</td>\n</tr>\n<tr>\n<td>hdop</td>\n<td>Dilución horizontal de la precisión del registro GPS. A menor valor, mejor calidad.</td>\n</tr>\n<tr>\n<td>referenciaDesde</td>\n<td>Zona del cliente donde comenzó el exceso (solo con referencia = true).</td>\n</tr>\n<tr>\n<td>referenciaHasta</td>\n<td>Zona del cliente donde terminó el exceso (solo con referencia = true).</td>\n</tr>\n<tr>\n<td>estadoCinturon</td>\n<td>Estado del cinturón del conductor: true (conectado), false (no conectado) o null (sin accesorio instalado).</td>\n</tr>\n<tr>\n<td>fechaInstalacion</td>\n<td>Fecha de instalación del equipo GPS en el vehículo.</td>\n</tr>\n<tr>\n<td>haveData, interseccion, referencia</td>\n<td>Valores de uso interno. No tienen significado para el consumidor.</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"importante\">IMPORTANTE</h3>\n<p>Para garantizar un rendimiento óptimo y una respuesta eficiente de la API, se recomienda enfáticamente que las peticiones se realicen utilizando un rango de tiempo limitado a 1 día. Esto significa que al solicitar datos, el intervalo entre la fecha de inicio y la fecha de fin no debe exceder las 24 horas.</p>\n","urlObject":{"protocol":"https","path":["v1","base","report-status"],"host":["reportes","waypoint","cl"],"query":[],"variable":[]}},"response":[],"_postman_id":"56f54721-285a-4c57-aa9c-0b762f1ad634"}]}