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