|
|
El evento es la parte principal de esta API de ingesta de datos. En este elemento es donde se va a enviar a la plataforma la información del evento generado por cada uno de los dispositivos en tiempo real.
|
|
|
|
|
|
- Method: POST
|
|
|
|
|
|
- URL: {baseUrl}/v1/**events**
|
|
|
|
|
|
- Body:
|
|
|
|
|
|
```
|
|
|
{
|
|
|
"companyId": "v2client.acme.com",
|
|
|
"actionId": "CLI_235",
|
|
|
"beaconId": "cff92179-dc0a-47da-bd9e-5e9c5b14d251",
|
|
|
"beaconTypeId": 1,
|
|
|
"timestamp": "2021-03-15T13:34:00.000",
|
|
|
"lonStart": -3.45368,
|
|
|
"latStart": -3.45368,
|
|
|
"lonEnd": 40.36586,
|
|
|
"latEnd": 40.36586,
|
|
|
"informationQualityId": 1,
|
|
|
"deviceTypeId": 1,
|
|
|
"speed": 120
|
|
|
}
|
|
|
```
|
|
|
|
|
|
**\* = Campo requerido**
|
|
|
|
|
|
- companyId * (texto): CN del certificado
|
|
|
|
|
|
- actionId * (texto): Identificador único del evento
|
|
|
|
|
|
- beaconId * (texto): identificador único de la baliza (por ejemplo, la MAC)
|
|
|
|
|
|
- beaconTypeId * (número entero): identificador del tipo de baliza. Posibles valores en /beaconTypes
|
|
|
|
|
|
- timestamp * (fecha UTC): fecha y hora en formato UTC del momento en el que el evento se ha generado. Es necesario que sea de un máximo de 30 segundos de antiguedad con respecto a la hora UTC
|
|
|
|
|
|
- lonStart * (número decimal): longitud de coordenadas de tipo WGS 84 donde se ha generado el evento
|
|
|
|
|
|
- latStart * (número decimal): latitud de coordenadas de tipo WGS 84 donde se ha generado el evento
|
|
|
|
|
|
- lonEnd (número decimal): longitud de coordenadas de tipo WGS 84 donde se ha generado el evento
|
|
|
|
|
|
- latEnd (número decimal): latitud de coordenadas de tipo WGS 84 donde se ha generado el evento
|
|
|
|
|
|
- informationQualityId * (número entero): identificador del tipo de calidad de la información. Posibles valores en /informationQualities
|
|
|
|
|
|
- deviceTypeId * (número entero): identificador del tipo de dispositivo desde el que se envía la información. Posibles valores en /deviceTypes
|
|
|
|
|
|
- speed * (número decimal): velocidad en kilómetros por hora a la que se encuentra el elemento en el momento que envía el evento |