Sviluppatori

Sviluppa con iotBind

API semplici pensate per i microcontrollori: un URL, una chiave del dispositivo e pochi parametri.

Ottieni la chiave del dispositivo Riferimento API

HTTP / HTTPS

Invia e leggi dati con richieste GET o POST e risposte JSON.

MQTT

Pubblica e iscriviti tramite il tuo broker MQTT.one per comandi istantanei.

Webhook

Ricevi notifiche firmate sul tuo server quando succede qualcosa.

Guida rapida

  1. 1

    Crea un account

    Registrati gratis e conferma il tuo indirizzo email.

  2. 2

    Aggiungi un dispositivo

    Aggiungi un interruttore, un sensore, un serbatoio o un tracker, poi apri l'icona della chiave per copiare l'ID univoco e la chiave segreta.

  3. 3

    Invia la tua prima richiesta

    Usa gli esempi qui sotto nel tuo sketch o provali nel browser.

Nozioni di base

L'indirizzo base della versione 1 dell'API è http://api.iotbind.com/v1 (HTTPS è supportato). Ogni richiesta include questi parametri, nella query string (GET) o come campi di un modulo (POST):

ParametroDescrizione
method"get" or "post": come vengono inviati i parametri. Sempre obbligatorio.
keyLa chiave API segreta del dispositivo. Sempre obbligatoria.
uidL'ID univoco del dispositivo. Sempre obbligatorio.

Mantieni segreta la chiave del dispositivo. Se viene divulgata, generane una nuova dall'icona della chiave del dispositivo: la vecchia chiave smette subito di funzionare.

Interruttori

Accendi o spegni un interruttore, salva fino a tre valori o leggi il suo stato attuale.

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

ParametroDescrizione
cmd Comando facoltativo: onoffgetping
data1 Testo o numero facoltativo da salvare.
data2 Testo o numero facoltativo da salvare.
data3 Testo o numero facoltativo da salvare.
Invia dati 
http://api.iotbind.com/v1/switch.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=on&data1=24.5&data2=OK
Risposta: {"MESSAGE":"UPDATED"}
Leggi il 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": ""
}

Gli stessi parametri funzionano come campi di un modulo POST con method=post · Per segnalare che il dispositivo è connesso, invia cmd=ping → {"MESSAGE":"PING OK"}

Sensori

Salva fino a tre letture o leggi gli ultimi valori.

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

ParametroDescrizione
cmd Comando facoltativo: getping
data1 Testo o numero facoltativo da salvare.
data2 Testo o numero facoltativo da salvare.
data3 Testo o numero facoltativo da salvare.
Invia dati 
http://api.iotbind.com/v1/sensor.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&data1=23.4&data2=41&data3=1012
Risposta: {"MESSAGE":"UPDATED"}
Leggi il 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"
}

Gli stessi parametri funzionano come campi di un modulo POST con method=post · Per segnalare che il dispositivo è connesso, invia cmd=ping → {"MESSAGE":"PING OK"}

Serbatoi di liquidi

Salva livello e temperatura del serbatoio, aziona la sua pompa o leggi il suo stato.

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

ParametroDescrizione
cmd Comando facoltativo (aziona la pompa del serbatoio): onoffgetping
level Livello del serbatoio (numero).
temperature Temperatura del serbatoio, facoltativa (numero).
Invia dati 
http://api.iotbind.com/v1/tank.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=on&level=67&temperature=21
Risposta: {"MESSAGE":"UPDATED"}
Leggi il 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"
}

Gli stessi parametri funzionano come campi di un modulo POST con method=post · Per segnalare che il dispositivo è connesso, invia cmd=ping → {"MESSAGE":"PING OK"}

Localizzazione GPS

Salva una posizione con fino a quattro valori aggiuntivi o leggi l'ultima posizione.

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

ParametroDescrizione
cmd Comando facoltativo: getping
latitude Latitudine (numero).
longitude Longitudine (numero).
data1 Testo o numero facoltativo da salvare.
data2 Testo o numero facoltativo da salvare.
data3 Testo o numero facoltativo da salvare.
data4 Testo o numero facoltativo da salvare.
Invia dati 
http://api.iotbind.com/v1/tracking.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&latitude=24.7136&longitude=46.6753&data1=62
Risposta: {"MESSAGE":"UPDATED"}
Leggi il 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"
}

Gli stessi parametri funzionano come campi di un modulo POST con method=post · Per segnalare che il dispositivo è connesso, invia cmd=ping → {"MESSAGE":"PING OK"}

MQTT

iotBind funziona con il servizio MQTT.one: la piattaforma pubblica sui tuoi topic quando un dispositivo cambia, e i tuoi dispositivi pubblicano messaggi JSON verso iotBind.

  1. Crea un account MQTT.one e aggiungi i topic che ti servono.
  2. Nella piattaforma, apri «MQTT service» e collega il tuo account MQTT.one.
  3. Nelle impostazioni del dispositivo, attiva «MQTT publish messages» e scegli il suo topic.
  4. Collega la tua scheda al broker con i tuoi dati MQTT.one, usando il client ID iotbind-<UNIQUE_ID>.
  5. Pubblica messaggi JSON sul topic iotbind indicato nel tuo account.
Messaggio al topic iotbind/switch/ 
{ "key": "DEVICE_KEY", "uid": "UNIQUE_ID", "cmd": "off", "data1": "24.5" }

MQTT richiede un piano con la funzionalità MQTT e un account su MQTT.one

Codici di errore

400Richiesta non valida: indirizzo, parametri o corpo non sono validi.
401Non autorizzato: la chiave del dispositivo o l'ID univoco sono errati.
404Non trovato: la risorsa richiesta non esiste.
429Troppe richieste: rallenta o controlla i limiti del tuo piano.

Il tuo prossimo progetto merita un cloud

Crea un account gratuito in un minuto e collega oggi stesso il tuo primo dispositivo.

Crea un account gratuito Parla con noi