Acerca de la API

El sistema UBB IOT ofrece una API para todos los programadores que deseen desarrollar su aplicaciones utilizando las mediciones obtenidas por lo sensores que se encuentran en la Universidad. Estos sensores miden la temperatura ambiente, radiación ultravioleta y la humedad relativa. Los sensores se distribuyen de la siguiente manera:

- Sensor N°1 mide la temperatura ambiente.

- Sensor N°2 mide la radiación ultravioleta.

- Sensor N°3 mide la humedad relativa.

Nota: Para utilizar la API usted debe registrarse y obtendrá un Token de Acceso con el cual podrá acceder a la API.

Instrucciones

Parámetros de acceso

Para acceder a los recursos que la API provee, son necesarios tres parámetros.

- Token de acceso: token de acceso necesaria para solicitar los recursos.

- Token del Sensor: Token del sensor que se desea consultar.

- Fecha: fecha específica o intervalo de fechas en formato ddmmyyyy.

Nombre del parámetro Tipo Descripción
Token de acceso String token para acceder a los métodos de la API
Token del Sensor String Token de sensor para acceder a una medición
Fecha String Permite acceder a las mediciones hechas en una fecha o intervalo de fechas

Llamadas a la API

Para acceder a las medición de cada sensor se debe ingresar su token de acceso el cual se presenta en la siguiente tabla:

Sensor Token de sensor
Temperatura ambiental E1yGxKAcrg
Radiación ultravioleta 8IvrZCP3qa
Humedad VIbSnGKyLW
Nota: Los sensores comenzaron a tomar las mediciones desde el 24 de enero de 2018, por lo que desde esa fecha en adelante se pueden obtener las mediciones.

Servicio web: mediciones realizadas en un fecha específica

Para acceder a las mediciones obtenidas en una fecha específica se debe ingresar la siguiente URL:

GET http://arrau.chillan.ubiobio.cl:8075/ubbiot/web/mediciones/medicionespordia/{TokenAcceso}/{TokenSensor}/{fecha}

Ejemplo

Considerando los parámetros necesarios como:

- {TokenAcceso}:NAUJ.

- {TokenSensor}: E1yGxKAcrg (Mide la temperatura ambiente).

- {Fecha}: 21022018 (21 de febrero de 2018).

Se debe acceder a la siguiente URL:

 http://arrau.chillan.ubiobio.cl:8075/ubbiot/web/mediciones/medicionespordia/NAUJ/E1yGxKAcrg/21022018

Servicio web: mediciones realizadas en un intervalo de fechas

Para acceder a las mediciones obtenidas en un intervalo de fechas, se debe ingresar la siguiente URL:

GET http://arrau.chillan.ubiobio.cl:8075/ubbiot/web/mediciones/medicionesporintervalofechas/{TokenAcceso}/{TokenSensor}/{fechaInicio}/{fechaFin}

Ejemplo

Considerando los parámetros necesarios como:

- {TokenAcceso}:NAUJ.

- {TokenSensor}: E1yGxKAcrg (Mide la temperatura ambiente).

- {FechaInicio}: 23022018 (23 de febrero de 2018).

- {FechaFin}: 25032018 (25 de marzo de 2018).

Se debe acceder la siguiente URL:

http://arrau.chillan.ubiobio.cl:8075/ubbiot/web/mediciones/medicionesporintervalofechas/NAUJ/E1yGxKAcrg/21022018/25032018

Formato salida de los datos

Nota: Las respuestas que entrega la API son en formato en JSON.

En el caso que la llamada a la API se exitosa, los datos se mostraran de la siguiente manera:

                        {
                            "success": true,
                            "data": [
                                {
                                    "fecha": "2018-02-24",
                                    "hora": "00:04:49",
                                    "valor": "95"
                                },
                                {
                                    "fecha": "2018-02-24",
                                    "hora": "00:19:53",
                                    "valor": "95"
                                }
                                    ]
                         }

En el caso de que falle la llamada a la API, los datos se mostraran de la siguiente manera:

                        {
                            "success": false,
                            "data": {
                            "statusCode": 404,
                            "name": "Not Found Exception",
                            "message": "Mensaje relacionado con el problema"
                            }
                         }

Token de acceso

El token de acceso es necesario para poder acceder a la API. Para obtenerlo es necesario registrarse e iniciar Sesión.