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ó BOTON DE PANICO el 2022/02/24 08:16:16<br /><br>",
"Latitud": "18.98043888996881",
"Longitud": "-98.22312211997996",
"Domicilio": "Boulevard Periférico Ecológico, Constitució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ó |
Cadena de Texto |
|
|
Domicilio |
Dirección correspondiente a la latitud y longitud |
Cadena de Texto |
|
|
StatusAlerta |
Nombre del estado del alerta, puede ser los siguientes:
|
Cadena de Texto |
|
|
TipoAlerta |
Nombre del tipo de alerta que se generó. |
Cadena de Texto |
|