| Parámetros | Descripción | Longitud | Ejemplo |
|---|---|---|---|
| apikey | **(Requerido)** Llave de autorización para uso de los Servicios Web. | 50 | 25sdsd234234aa93sdsdsd37c70118e72 |
| token | **(Requerido)** Token devuelto por el método getToken. | 500 | wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== |
| equipo | **(Requerido)** IMEI o Identificador único del dispositivo configurado en la plataforma. | 200 | 0580012342332337 |
| fechaIni | **(Requerido)** Fecha Inicial de los datos. | 19 | 2023-03-08 00:00:00 |
| fechaFin | **(Requerido)** Fecha Final de los datos. | 19 | 2023-03-08 23:59:59 |
| format | **(Requerido)** Si se pasan horas en **fechaIni** y **fechaFin** debe enviar “DateTime”, de lo contrario utilice “Date”. | 8 | DateTime |
| limite | **(Opcional)** Permite establecer un límite de filas de datos a recibir del WS, si no especifica un límite se regresan todos los datos. | 1 |
**Nota:** El limite máximo para consultar datos históricos es de 15 días por equipo.
##### Solicitud de ejemplo: ```shell curl --location --request POST 'https://api.service24gps.com/api/v1/history/get' \ --form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \ --form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \ --form 'equipo="0580012342332337"' \ --form 'fechaIni="2023-03-08 00:00:00"' \ --form 'fechaFin="2023-03-08 23:59:59"' \ --form 'format="DateTime"' \ --form 'limite="1"' ``` ##### Respuesta de ejemplo: ```JSON { "status": 200, "data": { "equipo": "0580012342332337", "latitud": "+19.528530", "longitud": "-99.171165", "iporigen": "", "puerto": "", "idstatus": "1", "gmt": "-5", "fecha": "2023-03-08", "hora": "23:59:39", "fecha_reporte": "20230308235939", "idevento": "1", "velocidad": "0", "orientacion": "0", "senal": "65", "satelites": "20", "inputs": "0|0|0|0|0|0|0|0|0|0|0|0|0|0|0", "odometro": "57373562", "bateria_gps": "100", "bateria_veh": "13.83", "ignicion": "1", "idconductor": "0", "domicilio": "Camino a San Juan Ixtacala 479, San Juan, Gustavo A. Madero, Mexico City, Mexico", "de_buffer": "0", "datos_extras": "{\"parameters\":{\"out_1\":\"0\",\"out_2\":\"0\",\"out_3\":\"0\",\"out_4\":\"0\",\"out_5\":\"0\",\"out_6\":\"0\",\"out_7\":\"0\",\"out_8\":\"0\"},\"outputs\":\"0|0|0|0|0|0|0|0\",\"Time_stamp_insert\":\"20210427201542\",\"tipo_dato\":{\"1\":\"2021-04-28 01:15:42\",\"13\":\"2021-04-27 21:04:29\",\"55\":\"2021-04-27 21:04:30\",\"14\":\"2021-04-27 21:05:42\",\"3\":\"2021-04-27 21:03:42\"},\"gw\":\"Escuchar-ST4340-TCP.php\",\"ip\":\"107.170.254.11\",\"kp\":\"6088b73e3a7f5\"}", "grupo": "Flota 1", "conductor": "", "patente": "ABC-813", "activo": "Activo-01" } } ```| Campo | Descripción | Formato | |
|---|---|---|---|
| equipo | Número de serie o IMEI que permite identificar el dispositivo. | Entero | |
| latitud | Latitud de la posición del vehículo. | Grados decimales | |
| longitud | Longitud de la posición del vehículo. | Grados decimales | |
| iporigen | Ip de origen de reporte del equipo GPS. | Cadena de texto | |
| puerto | Puerto de origen de reporte del equipo GPS. | Entero | |
| idstatus | Status de la información que reportó el equipo: 1 = Información actual 2 = Información a futuro. | Entero | |
| gmt | Greenwich Mean Time. | Cadena de texto | |
| fecha | Fecha | aaaa-mm-dd | |
| hora | Hora | hh:mm:ss | |
| fecha\_reporte | Fecha hora de la posición del vehículo. | DateTime | |
| idevento | Identificador del evento que reportó el equipo GPS. | Entero | |
| velocidad | Velocidad en km/h que detecta el equipo GPS. | Entero | |
| orientacion | Orientación en grados en la que reportó el equipo GPS. | Entero | |
| senal | Señal GSM del equipo GPS. | Entero | |
| satelites | Cantidad de satélites. | Entero | |
| inputs | Estados de cada entrada del equipo: 0 = Desactivada 1 = Activada | Cadena de texto | |
| odometro | Metros (mts) que ha recorrido el vehículo, detectado por el GPS. | Entero | |
| bateria\_gps | Porcentaje o voltaje del nivel de la batería interna del GPS. | Entero | Decimales | |
| bateria\_veh | Voltaje (v) de la batería del vehículo. | Decimales | |
| ignicion | Status Ignición: 0 = OFF 1 = ON 2 = Desconocida | Entero | |
| IdConductor | Id del conductor autentificado, Ibutton | Entero | |
| de\_buffer | Status del tipo de reporte: 0 = Sin Buffer 1 = Buffer | Entero | |
| datos\_extras | Valores que son obtenidos del protocolo OBDII. | JSON | |
| grupo | Nombre del grupo | Cadena de texto | |
| conductor | Nombre del conductor | Cadena de texto | |
| patente | Patente del activo | Cadena de texto | |
| activo | Nombre del activo | Cadena de texto |