Desarrolladores

Desarrolla con iotBind

APIs sencillas diseñadas para microcontroladores: una URL, una clave de dispositivo y unos pocos parámetros.

Obtén tu clave de dispositivo Referencia de la API

HTTP / HTTPS

Envía y lee datos con peticiones GET o POST y respuestas JSON.

MQTT

Publica y suscríbete a través de tu broker MQTT.one para comandos instantáneos.

Webhooks

Recibe notificaciones firmadas en tu propio servidor cuando ocurre algo.

Inicio rápido

  1. 1

    Crea una cuenta

    Regístrate gratis y confirma tu dirección de correo electrónico.

  2. 2

    Añade un dispositivo

    Añade un interruptor, sensor, depósito o localizador y abre su icono de llave para copiar el ID único y la clave secreta.

  3. 3

    Envía tu primera petición

    Usa los ejemplos de abajo en tu sketch o pruébalos en tu navegador.

Conceptos básicos

La dirección base de la versión 1 de la API es http://api.iotbind.com/v1 (se admite HTTPS). Cada petición incluye estos parámetros, ya sea en la cadena de consulta (GET) o como campos de formulario (POST):

ParámetroDescripción
method"get" or "post": cómo se envían los parámetros. Siempre obligatorio.
keyLa clave secreta de la API del dispositivo. Siempre obligatoria.
uidEl ID único del dispositivo. Siempre obligatorio.

Mantén en secreto la clave del dispositivo. Si se filtra, genera una nueva desde el icono de llave del dispositivo: la clave anterior deja de funcionar al instante.

Interruptores

Enciende o apaga un interruptor, guarda hasta tres valores o lee su estado actual.

GET | POST http://api.iotbind.com/v1/switch.php

ParámetroDescripción
cmd Comando opcional: onoffgetping
data1 Texto o número opcional que se guardará.
data2 Texto o número opcional que se guardará.
data3 Texto o número opcional que se guardará.
Enviar datos 
http://api.iotbind.com/v1/switch.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=on&data1=24.5&data2=OK
Respuesta: {"MESSAGE":"UPDATED"}
Leer el dispositivo 
http://api.iotbind.com/v1/switch.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=get
{
  "uid": "UNIQUE_ID", "name": "Living room", "type": "RGB Light", "cmd": "on",
  "data1": "24.5", "data1_unit": "C", "data2": "OK", "data2_unit": "", "data3": "", "data3_unit": ""
}

Los mismos parámetros funcionan como campos de formulario POST con method=post · Para indicar que el dispositivo está conectado, envía cmd=ping → {"MESSAGE":"PING OK"}

Sensores

Guarda hasta tres lecturas o lee los últimos valores.

GET | POST http://api.iotbind.com/v1/sensor.php

ParámetroDescripción
cmd Comando opcional: getping
data1 Texto o número opcional que se guardará.
data2 Texto o número opcional que se guardará.
data3 Texto o número opcional que se guardará.
Enviar datos 
http://api.iotbind.com/v1/sensor.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&data1=23.4&data2=41&data3=1012
Respuesta: {"MESSAGE":"UPDATED"}
Leer el dispositivo 
http://api.iotbind.com/v1/sensor.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=get
{
  "uid": "UNIQUE_ID", "name": "Greenhouse", "type": "Temperature",
  "data1": "23.4", "data1_unit": "C", "data2": "41", "data2_unit": "%", "data3": "1012", "data3_unit": "hPa"
}

Los mismos parámetros funcionan como campos de formulario POST con method=post · Para indicar que el dispositivo está conectado, envía cmd=ping → {"MESSAGE":"PING OK"}

Depósitos de líquido

Guarda el nivel y la temperatura del depósito, acciona su bomba o lee su estado.

GET | POST http://api.iotbind.com/v1/tank.php

ParámetroDescripción
cmd Comando opcional (acciona la bomba del depósito): onoffgetping
level Nivel del depósito (número).
temperature Temperatura opcional del depósito (número).
Enviar datos 
http://api.iotbind.com/v1/tank.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=on&level=67&temperature=21
Respuesta: {"MESSAGE":"UPDATED"}
Leer el dispositivo 
http://api.iotbind.com/v1/tank.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=get
{
  "uid": "UNIQUE_ID", "name": "Roof tank", "type": "Water Level", "cmd": "on",
  "level": "67", "level_unit": "%", "temperature": "21", "temperature_unit": "C"
}

Los mismos parámetros funcionan como campos de formulario POST con method=post · Para indicar que el dispositivo está conectado, envía cmd=ping → {"MESSAGE":"PING OK"}

Localización GPS

Guarda una posición con hasta cuatro valores adicionales o lee la última posición.

GET | POST http://api.iotbind.com/v1/tracking.php

ParámetroDescripción
cmd Comando opcional: getping
latitude Latitud (número).
longitude Longitud (número).
data1 Texto o número opcional que se guardará.
data2 Texto o número opcional que se guardará.
data3 Texto o número opcional que se guardará.
data4 Texto o número opcional que se guardará.
Enviar datos 
http://api.iotbind.com/v1/tracking.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&latitude=24.7136&longitude=46.6753&data1=62
Respuesta: {"MESSAGE":"UPDATED"}
Leer el dispositivo 
http://api.iotbind.com/v1/tracking.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=get
{
  "uid": "UNIQUE_ID", "name": "Car", "type": "GPS tracking",
  "latitude": "24.7136", "longitude": "46.6753", "data1": "62", "data1_unit": "km/h"
}

Los mismos parámetros funcionan como campos de formulario POST con method=post · Para indicar que el dispositivo está conectado, envía cmd=ping → {"MESSAGE":"PING OK"}

MQTT

iotBind funciona con el servicio MQTT.one: la plataforma publica en tus topics cuando un dispositivo cambia, y tus dispositivos publican mensajes JSON hacia iotBind.

  1. Crea una cuenta en MQTT.one y añade los topics que necesites.
  2. En la plataforma, abre «MQTT service» y vincula tu cuenta de MQTT.one.
  3. En la configuración del dispositivo, activa «MQTT publish messages» y elige su topic.
  4. Conecta tu placa al broker con tus datos de MQTT.one, usando el ID de cliente iotbind-<UNIQUE_ID>.
  5. Publica mensajes JSON en el topic iotbind que aparece en tu cuenta.
Mensaje al topic iotbind/switch/ 
{ "key": "DEVICE_KEY", "uid": "UNIQUE_ID", "cmd": "off", "data1": "24.5" }

MQTT requiere un plan con la función MQTT y una cuenta en MQTT.one

Códigos de error

400Petición incorrecta: la dirección, los parámetros o el cuerpo no son válidos.
401No autorizado: la clave del dispositivo o el ID único no son correctos.
404No encontrado: el recurso solicitado no existe.
429Demasiadas peticiones: reduce la frecuencia o revisa los límites de tu plan.

Tu próximo proyecto merece una nube

Crea una cuenta gratuita en un minuto y conecta tu primer dispositivo hoy mismo.

Crear una cuenta gratuita Habla con nosotros