Intercambio de datos flexible
Introducción
El intercambio de datos flexible es la forma de integración por HTTP recomendada cuando no es posible modificar el formato de los datos enviados por el dispositivo.
El intercambio flexible de datos soporta únicamente mensajes de Uplink. Los mensajes de uplink son todos aquellos enviados desde los dispositivos hacia la plataforma. La plataforma debe ser capaz de procesar los mensajes de uplink para almacenar la información relevante, y procesarla. Esto se logra utilizando scripting para interpretar el contenido de los mensajes y almacenar la información en la plataforma.
No es posible enviar mensajes de Downlink (es decir, desde la plataforma hacia el dispositivo) utilizando el intercambio flexible de datos por HTTP.
Pasos a seguir
Configuración de la URL de envío de datos a la plataforma
Para que la plataforma pueda recibir los datos del dispositivo, será necesario configurarlo para hacer POST de mensajes HTTP a la siguiente URL:
https://gear.cloud.studio/api/v2/uplink/{DeviceAddress}Donde:
- DeviceAddress es la dirección del dispositivo, tal como ha sido ingresada al crear el dispositivo en la plataforma.
Por ejemplo, si la dirección del dispositivo es 06A022B39C14, entonces deberá ser configurado para hacer POST a la siguiente URL:
https://gear.cloud.studio/api/v2/uplink/06A022B39C14Configuración del access token
Es necesario además enviar el access token como parte del encabezado, utilizando un encabezado Authorization, como se ve a continuación:
Authorization: Bearer e54e0911-ece3-4b7a-b84d-afc01dfa81f1Alternativamente, cuando no es posible enviar el token a través del encabezado Authorization, el access token puede enviarse como parte de la url, a través del parámetro “accessToken”, como en el siguiente ejemplo:
https://gear.cloud.studio/api/v2/uplink/06A022B39C14?accessToken=e54e0911-ece3-4b7a-b84d-afc01dfa81f1Una vez completados estos pasos, la plataforma comenzará a recibir y procesar la información del dispositivo. Si se trata de un dispositivo de un modelo no soportado nativamente por la plataforma, será necesario además definir los scripts de procesamiento de datos, como se describe en esta sección.
Última actualización
HTTP
Cómo integrar dispositivos con Gear Studio por HTTP, desde equipos de distintos fabricantes hasta desarrollos propios con Arduino o Raspberry Pi.
API HTTP
La API HTTP de Gear Studio permite que los dispositivos suban datos, actualicen su estado y reciban comandos con un formato de mensaje documentado.