Equipos

• Datos históricos de eventos del equipo - historyGetEvents
• Datos históricos equipo - history/get
• Obtener listado de marcas y modelos - getBrandsAndModels
• Obtener alertas por día - getAlerts
• Lista de eventos - getEventTypes
• Lista de sensores - GetSensors

Datos históricos de eventos del equipo - historyGetEvents

POST https://api.service24gps.com/api/v1/historyGetEvents

Este método permite consultar los datos históricos de los eventos de un equipo para un rango de fechas y horas especificados.

Ver parámetros de solicitud:

Parámetros	Descripción	Longitud	Ejemplo
apikey	Llave de autorización para uso de los Servicios Web.	50	25sdsd234234aa93sdsdsd37c70118e72
token	Token devuelto por el método getToken.	500	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
equipo	IMEI o Identificador único del dispositivo configurado en la plataforma.	200	0580012342332337
fechaIni	Fecha Inicial de los datos.	19	2021-04-27 00:00:00
fechaFin	Fecha Final de los datos.	19	2021-04-27 23:59:59
format	Si se pasan horas en fechaIni y fechaFin debe enviar “DateTime”, de lo contrario utilice “Date”.	8	DateTime
idsEvents	Se específica un o muchos Id de los eventos a consultar, separados por coma sin espacios. Si no se especifican se obtienen todos los eventos que no sean ubicación.		1321,1322,1323,1324,1325,1326,1336, 1337,1338,1339

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/historygetevents' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'equipo="0580012342332337"' \
--form 'fechaIni="2021-04-27 00:00:00"' \
--form 'fechaFin="2021-04-27 23:59:59"' \
--form 'format="DateTime"' \
--form 'idsEvents="1321,1322,1323,1324,1325,1326,1336,1337,1338,1339"'

{
	"status": 200,
	"data": {
            "equipo": "0580012342332337",
            "latitud": "19.528530",
            "longitud": "--99.171165",
            "idstatus": "1",
            "gmt": "-6",
            "fecha": "2024-01-04",
            "hora": "10:14:18",
            "fecha_reporte": "20240104101418",
            "idevento": "348",
            "velocidad": "0",
            "orientacion": "0",
            "senal": "0",
            "satelites": "0",
            "inputs": "0|0|0|0|0|0|0|0|0|0|0|0|0|0|0",
            "odometro": "0",
            "bateria_gps": "86",
            "bateria_veh": "0",
            "ignicion": "1",
            "idconductor": "34110",
            "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": "CONDUCTORES MX",
            "conductor": "CONDUCTOR1",
            "patente": "ABC123",
            "activo": "ACTIVO 1"
	}
}

Respuesta de ejemplo:

Ver campos de respuesta:

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
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 de la posición del vehículo.	DateTime
hora	Hora de la posición del vehículo.	HH::MM:SS
fecha_reporte	Fecha y hora de la posición del vehículo.	Timestamp
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
domicilio	Domicilio.	Cadena de texto
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 que pertenece.	Cadena de texto
conductor	Nombre del conductor.	Cadena de texto
patente	Nombre de la patente.	Cadena de texto
activo	Nombre del activo.	Cadena de texto

Datos históricos equipo - history/get

POST https://api.service24gps.com/api/v1/history/get 

Este método permite consultar los datos históricos de un equipo para un rango de fechas y horas especificados.

Ver parámetros de solicitud:

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:

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:

{
	"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"
	}
}

Ver campos de respuesta:

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

Obtener listado de marcas y modelos - getBrandsAndModels

POST https://api.service24gps.com/api/v1/getBrandsAndModels

Obtiene el listado completo de marcas y modelos de dispositivos disponibles en la plataforma.

Ver parámetros de solicitud:

Parámetros	Descripción	Ejemplo
apikey	Llave de autorización para uso de los Servicios Web.	25sdsd234234aa93sdsdsd37c70118e72
token	Token devuelto por el método getToken.	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/getBrandsAndModels' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'

Respuesta de ejemplo:

{
  
    "status": 200,
    "data": [
        {
            "id": "299",
            "marca": "Zenda",
            "modelos": [
                {
                    "id": "77",
                    "modelo": " ZD-VT2"
                },
                {
                    "id": "1006",
                    "modelo": "ZD-VT1"
                }
            ]
        },
        {
            "id": "150",
            "marca": "Yulongda technology limited",
            "modelos": [
                {
                    "id": "1474",
                    "modelo": "GT06H"
                },
                {
                    "id": "371",
                    "modelo": "YuLongDa GT06"
                }
            ]
        },
        {
            "id": "384",
            "marca": "Accurate Technology",
            "modelos": [
                {
                    "id": "1533",
                    "modelo": "TK100"
                }
            ]
        }
    ]
}

Obtener alertas por día - getAlerts

POST https://api.service24gps.com/api/v1/getAlerts

Obtiene las alertas generadas en el rango de fechas indicado para un equipo específico, un grupo de Activos o todos los equipos asociados al usuario.

Ver parámetros de solicitud:

Parámetros	Descripción	Ejemplo
apikey	(Requerido) Llave de autorización para uso de los Servicios Web.	25sdsd234234aa93sdsdsd37c70118e72
token	(Requerido) Token devuelto por el método getToken.	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
idgrupo	(Opcional) Identificador único del grupo de Activos. Este parámetro tiene prioridad sobre equipo; si se especifica, la consulta se realizará para los Activos pertenecientes al grupo indicado. Para obtener los identificadores disponibles, consulte el método getAssetGroups.  Nota: Si se desea realizar la consulta únicamente para un equipo, este parámetro debe enviarse vacío.	45665
equipo	(Requerido) IMEI del equipo del cual se desean obtener las alertas. Este parámetro será considerado únicamente cuando idgrupo no se especifique.	354148072188807
fecha_inicio	(Requerido) Fecha de inicio del rango para la consulta de alertas.	2026-08-01
fecha_fin	(Requerido) Fecha de fin del rango para la consulta de alertas.	2026-08-14

Si los parámetros idgrupo y equipo se envían vacíos, la consulta devolverá las alertas de todos los Activos asociados al usuario.

Si ambos campos de fecha se dejan vacíos, la consulta se realizará para el día actual.

Solo es posible consultar rangos de hasta 14 días.

Solicitud de ejemplo:

curl --location 'https://api.service24gps.com/api/v1/getAlerts' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'idgrupo="45665"' \
--form 'equipo="354148072188807"' \
--form 'fecha_inicio="2026-08-01"' \
--form 'fecha_fin="2026-08-14"'

Respuesta de ejemplo:

{
	"status": 200,
	"data": {
    	"Equipo": "354148072188807",
        "Fecha": "2026-08-10",
      	"Hora": "08:16:16",
      	"Descripcion": "Unidad   Gener&oacute; BOTON DE PANICO el 2022/02/24 08:16:16<br /><br>",
        "Latitud": "18.98043888996881",
        "Longitud": "-98.22312211997996",
        "Domicilio": "Boulevard Perif&eacute;rico Ecol&oacute;gico, Constituci&oacute;n Loma Bella, 72474 Puebla, Puebla",
        "StatusAlerta": "FUERA DE LA GEOCERCA",
      	"TipoAlerta": "Geocerca E/S"
    }
}

Ver campos de respuesta:

Campo	Descripción	Formato
Equipo	Equipo asignado al vehículo que ejecutó la alerta.	Cadena de Texto
Fecha	Fecha en la que la alerta se ejecutó.	DateTime
Hora	Hora de la alerta (se maneja en formato de 24 hrs.)	DateTime
Descripción	Texto descriptivo de la alerta.	Cadena de Texto
Latitud	Latitud correspondiente al punto en que se originó la alerta.	Cadena de Texto
Longitud	Longitud correspondiente al punto en que se originó la alerta.	Cadena de Texto
Domicilio	Dirección correspondiente a la latitud y longitud reportada por el equipo.	Cadena de Texto
StatusAlerta	Nombre del estado del alerta, puede ser los siguientes: IGNICIÓN ON IGNICIÓN OFF DENTRO DE LA GEOCERCA FUERA DE LA GEOCERCA TEMPERATURA LIMITE INFERIOR TEMPERATURA LIMITE SUPERIOR	Cadena de Texto
TipoAlerta	Nombre del tipo de alerta que se generó.	Cadena de Texto

Lista de eventos - getEventTypes

POST https://api.service24gps.com/api/v1/getEventTypes

Obtiene el listado de todos los eventos disponibles en la plataforma.

Ver parámetros de solicitud:

Parámetros	Descripción	Longitud	Ejemplo
apikey	Llave de autorización para uso de los Servicios Web.	50	25sdsd234234aa93sdsdsd37c70118e72
token	Token devuelto por el método getToken.	500	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/getEventTypes' \
--header 'Cookie: PHPSESSID=0ab8djc97ouk13tev2t9epf1l2' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'

Respuesta de ejemplo:

{
    "status": 200,
    "data": {
        "1": "Ubicación",
        "2": "Botón SigMen",
        "3": "Activo Detenido",
        "4": "Botón de Pánico ON",
        "5": "Puerta Conductor",
		...
    }
}

Ver campos de respuesta:

Campo	Descripción	Formato
id	Identificador único del evento en el sistema.	Entero
nombre	Nombre del evento	Texto

Lista de sensores - GetSensors

POST https://api.service24gps.com/api/v1/getSensors

Obtiene el listado de todos los sensores disponibles en la plataforma.

Ver parámetros de solicitud:

Parámetros	Descripción	Longitud	Ejemplo
apikey	Llave de autorización para uso de los Servicios Web.	50	25sdsd234234aa93sdsdsd37c70118e72
token	Token devuelto por el método getToken.	500	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/getSensors' \
--header 'Cookie: PHPSESSID=0ab8djc97ouk13tev2t9epf1l2' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'

Respuesta de ejemplo:

{
    "status": 200,
    "data": {
        "1": "Ignición ON / OFF",
        "2": "Desconexión de Batería Principal",
        "3": "Botón de Pánico",
        "4": "Corte Remoto de Combustible",
        "5": "Apertura / Cierre de puertas",
        ...
    }
}

Ver campos de respuesta:

Campo	Descripción	Formato
id	Identificador único del sensor.	Entero
nombre	Nombre del sensor	Texto