Version: es-1.0.0

HTTP

Los 煤nicos metodos habilitados para trabajar en la plataforma son GET y POST para consultar y guardar datos respectivamente de cada uno de los nodos, tener en cuenta la siguiente informaci贸n al momento de implementar HTTP en el dise帽o de los nodos IoT

  • {URL}: https://api.wiridlab.site/api/iot/devices/<nodeApiName>
  • {HEADERS} : En la petici贸n HTTP debe incluirse la cabecera WIRID-LAB-AUTH-TOKEN el string generado para consutar o guardar datos
  • {BODY} : Para almacenar datos el cuerpo del mensaje debe ser un vector de objetos [{data1},{data2},{data_n}]

A continuaci贸n se mostrar谩n dos ejemplos utilizando la herramienta POSTMAN

Guardar Datos#

  1. Ingrese la URL con met贸do POST
  2. Incluya el token en la cabecera WIRID-LAB-AUTH-TOKEN
  3. Incluya la cabecera Content-Type con valor application/json
  4. En la pesta帽a body seleccionar tipo dato raw e ingrese datos de ejemplo con formato vector de objetos
  5. Oprima el bot贸n enviar
  6. La respuesta de la plataforma ser谩 {"message": "Data Saved"}
  7. Si existe algun error para almacenar los datos , la plataforma reponder谩 con error 401
caution

Si {BODY} o {data_n} no es un array de objetos JSON no se almacenar谩 ninguna informaci贸n.

info

Los datos enviados en el array de objetos ser谩n almacenados de forma independiente.

info

si en {data_n} no existe el dato created se almacenar谩 por defecto la fecha y hora de la petici贸n.

caution

Si la informaci贸n de su nodo contiene ubicaciones por GPS , recuerde que el formato debe ser {"position": { "lat": FLOAT, "lng": FLOAT }}

Consultar datos#

  1. Ingrese la URL con met贸do GET
  2. Incluya el token en la cabecera WIRID-LAB-AUTH-TOKEN
  3. Incluya la cabecera Content-Type con valor application/json
  4. Oprima el bot贸n enviar
  5. La respuesta de la plataforma ser谩 un vector de objetos con los datos almacenados del nodo IoT correspondiente
  6. Si existe algun error para consultar los datos , la plataforma reponder谩 con error 401

Recursos#

A continuaci贸n encontrar谩 algunos recursos para usar el WIRID-LAB IoT.

Arduino#

Python#

Angular#