Uno de los mayores dolores de cabeza en el despliegue de soluciones IoT es configurar y desarrollar el servicio en la nube para almacenar y visualizar los datos de múltiples dispositivos. Debes crear diferentes dispositivos, variables, garantizar caminos de comunicación y provisionar cómo manejar los datos una vez que se envían a la nube. Con los recientes avances en la API de Ubidots, eliminamos el dolor de cabeza al permitir que las Etiquetas de API se utilicen en el firmware de tu dispositivo para llenar automáticamente tu cuenta de Ubidots con un Dispositivo y sus Variables al recibir la primera solicitud POST. Esto significa que con un solo código ahora puedes desplegar cientos de dispositivos de manera eficiente sin tener que configurar manualmente cada dispositivo con sus variables en Ubidots.

Si eres un usuario común de Ubidots, sabrás que Ubidots solía funcionar de la misma manera que muchas otras plataformas IoT, utilizando identificadores únicos como IDs para reconocer el dispositivo y la variable creados en tu cuenta de Ubidots. Ahora ya no tienes que crear cada dispositivo y cada variable gracias a la creación de Etiquetas de API.

¿Qué es una Etiqueta de API de dispositivo/variable? Las Etiquetas de API son identificadores únicos para dispositivos y variables que mantienen tus datos organizados en el backend de series temporales de Ubidots. Cada etiqueta es un identificador específico interpretado por Ubidots como una forma única y singular de diferenciar entre dispositivos y variables para los usuarios. Esto es lo que te permite transferir datos entre el dispositivo y Ubidots y visualizar datos sin confusión o contaminación de los datos de otros dispositivos. No se recomienda cambiar la Etiqueta de Dispositivo o la Etiqueta de Variable, ya que cualquier ajuste a estas entradas resultará en errores y transmisión de datos defectuosa.

¿Dónde puedo encontrar mi Etiqueta de API? Las Etiquetas de API de Ubidots son identificadores únicos alfanuméricos creados por el usuario para el dispositivo y sus variables. Recomendamos usar la dirección MAC de cada dispositivo para garantizar una etiqueta única que sepa qué dispositivo coincide con su visualización de datos específica en Ubidots. Por supuesto, la nomenclatura depende de ti, así que diseña como lo consideres adecuado.

Al usar Etiquetas de API en tu solicitud POST, los dispositivos y las variables se crean automáticamente cuando la solicitud es recibida por Ubidots. A continuación se muestra un ejemplo de solicitud POST para 3 sensores, pero puedes extenderlo a más si lo deseas.

Estructura de Solicitud POST

POST /api/v1.6/devices/{API_LABEL_FOR DEVICE}/?token={TOKEN} HTTP/1.1Host: industrial.api.ubidots.comContent-Type: application/jsonContent-Length: 51{"temperature": 25, "humidity": 56, "pressure": 63}

Como puedes ver arriba, la solicitud se está publicando en el host industrial.api.ubidots.com y en el punto final /api/v1.6/devices/{API_LABEL_FOR_DEVICE}/?token={YOUR_UBIDOTS_TOKEN}. Aquí asignarás tu propia Etiqueta de API para el nombre del dispositivo dentro de tu cuenta de Ubidots. Por el contrario, las Etiquetas de API para variables se incluyen en la carga útil de la solicitud; como se muestra arriba, la carga útil es {"temperature": 25, "humidity": 56, "pressure": 63} donde las Etiquetas de API han sido provisionadas como "temperature," "humidity," y "pressure."

Ejemplo de Solicitud:

curl -X POST -H "Content-Type: application/json" -d '{"temperature": 25, "humidity": 56, "pressure": 63}' "https://industrial.api.ubidots.com/api/v1.6/devices/new-device/?token=BBFF-FWFRcjDns1rZEqPSnU73erdM6pSFew"

Respuesta de Solicitud:

{    "pressure": [{"status_code": 201}],     "temperature": [{"status_code": 201}],     "humidity": [{"status_code": 201}]}

Ten en cuenta que si un dispositivo con la etiqueta de API = "new-device" no existe en tu cuenta, se creará automáticamente un nuevo dispositivo con 3 variables temperature, humidity y pressure en tu cuenta. Si el dispositivo con la Etiqueta de API "my-new-device" ya existe, los datos se publican en el dispositivo ya existente en tu cuenta. Más detalles se pueden encontrar aquí.

En este artículo hemos explicado la utilidad de las Etiquetas de API y el valor de ahorro de tiempo que este desarrollo de firmware agrega a tu despliegue. Con una simple solicitud POST, puedes lanzar Dispositivos y Variables en una cuenta de Ubidots sin requerir configuraciones adicionales de la aplicación.

Si estás desplegando una gran solución IoT y tienes varios dispositivos, las Etiquetas de API te harán la vida mucho más fácil. Puedes personalizar tu firmware para obtener la dirección MAC de cada dispositivo y asignarla como Etiqueta de API de Dispositivo, asegurándote de que sea única en tu cuenta de Ubidots.

Para probar la velocidad y capacidades de tu despliegue, visita Ubidots y aprovecha la Prueba Gratuita de 30 Días para integrar tus soluciones conectadas con facilidad.

Otros usuarios también encontraron útil: