|
|
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:
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
"companyId": "v2client.acme.com",
|
|
|
"actionId": "CLI_235",
|
|
|
"dgtId": "DGT_10928",
|
|
|
"dgtSecurityId": "DGT_SEC_18293",
|
|
|
"beaconId": "cff92179-dc0a-47da-bd9e-5e9c5b14d251",
|
|
|
"beaconTypeId": 1,
|
|
|
"timestamp": "2021-03-15T13:34:00.000",
|
|
|
"lon": -3.45368,
|
|
|
"lat": 40.36586,
|
|
|
"eventTypeId": 1,
|
|
|
"informationQualityId": 1,
|
|
|
"speed": 120
|
|
|
}
|
|
|
```
|
|
|
|
|
|
**\* = Campo requerido**
|
|
|
|
|
|
- companyId * (texto): CN del certificado
|
|
|
|
|
|
- actionId * (texto): Identificador único del evento
|
|
|
|
|
|
- dgtId (texto):
|
|
|
|
|
|
- dgtSecurityId (texto):
|
|
|
|
|
|
- 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
|
|
|
|
|
|
- lon * (número decimal): longitud de coordenadas de tipo WGS 84 donde se ha generado el evento
|
|
|
|
|
|
- lat * (número decimal): latitud de coordenadas de tipo WGS 84 donde se ha generado el evento
|
|
|
|
|
|
- eventTypeId * (número entero): identificador del tipo de evento. Posibles valores en /eventTypes
|
|
|
|
|
|
- informationQualityId * (número entero): identificador del tipo de calidad de la información. Posibles valores en /informationQualities
|
|
|
|
|
|
- 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 |