Formato de trama

Las tramas que se pueden enviar a la plataforma IoT pueden ser de dos tipos. O histórica o real-time. La diferencia entre ellas es que la histórica requerirá un argumento que especifique la fecha de los datos que se envían. Los datos de las tramas RT se guardarán con la fecha en la que la API recibe esta trama.

El formato de ambas tramas será JSON y a continuación se detallan las propiedades que necesitan:

Trama histórica

La trama histórica tiene un atributo HIST del que cuelgan todos los demás:

VERSION: Valor informativo en el que se puede incluir la versión del firmware. Este valor no se procesa y no se utiliza en nuestra plataforma, pero sirve para poder detectar los afectados de posibles fallos si se están recibiendo tramas con formatos inválidos o datos incorrectos.
IMEI: Código identificador del dispositivo. Todos los datos que envía un dispositivo tienen que hacerlo con el mismo IMEI o se tratarán como si fueran de dispositivos diferentes.
UTC: Fecha de envío de los datos en formato UNIX en segundos.
DATA: Objeto que incluye los datos enviados. Se pueden enviar tantas variables como sean necesarias. Como clave se usará un código identificativo de la variable. Coméntanos qué variables vais a enviar por si ya tenemos variables reservadas para estas.

Ejemplo para el dispositivo TEST-DEVICE enviando temperatura a 17.14ºC, humedad a 34.53% y batería a 3.5985 VDC el lunes 15 de junio de 2024 a las 14:44:48 UTC:

{
    "HIST": {
        "VERSION": "TEST",
        "IMEI": "TEST-DEVICE",
        "UTC": 1705329888,
        "DATA": {
            "TA_0": 17.14,
            "HR_0": 34.53,
            "BAT": 3.5985
        }
    }
}

Trama real-time

La trama real-time tiene el mismo formato que la histórica a diferencia que la propiedad padre es RT en lugar de HIST y omite la propiedad UTC. El mismo ejemplo de trama histórica que el anterior en formato RT sería el siguiente (tal como se ha explicado anteriormente, en este caso la fecha de los datos sería la fecha en la que se ha recibido esta trama):

{
    "RT": {
        "VERSION": "TEST",
        "IMEI": "TEST-DEVICE",
        "DATA": {
            "TA_0": 17.14,
            "HR_0": 34.53,
            "BAT": 3.5985
        }
    }
}