Geliştiriciler

iotBind üzerinde geliştirin

Mikrodenetleyiciler için tasarlanmış basit API'ler: bir URL, bir cihaz anahtarı ve birkaç parametre.

Cihaz anahtarınızı alın API başvurusu

HTTP / HTTPS

GET veya POST istekleri ve JSON yanıtlarıyla veri gönderin ve okuyun.

MQTT

Anında komutlar için MQTT.one broker'ınız üzerinden yayınlayın ve abone olun.

Webhook'lar

Bir şey olduğunda kendi sunucunuzda imzalı bildirimler alın.

Hızlı başlangıç

  1. 1

    Hesap oluşturun

    Ücretsiz kaydolun ve e-posta adresinizi doğrulayın.

  2. 2

    Cihaz ekleyin

    Bir anahtar, sensör, depo veya takip cihazı ekleyin, ardından benzersiz kimliği ve gizli anahtarı kopyalamak için anahtar simgesini açın.

  3. 3

    İlk isteğinizi gönderin

    Aşağıdaki örnekleri sketch'inizde kullanın veya tarayıcınızda test edin.

Temel bilgiler

API sürüm 1'in temel adresi http://api.iotbind.com/v1 şeklindedir (HTTPS desteklenir). Her istek bu parametreleri sorgu dizesinde (GET) veya form alanları olarak (POST) taşır:

ParametreAçıklama
method"get" veya "post": parametrelerin nasıl gönderileceği. Her zaman zorunlu.
keyCihazın gizli API anahtarı. Her zaman zorunlu.
uidCihazın benzersiz kimliği. Her zaman zorunlu.

Cihaz anahtarını gizli tutun. Sızdırılırsa cihazın anahtar simgesinden yenisini oluşturun: eski anahtar hemen çalışmayı durdurur.

Anahtarlar

Bir anahtarı açın veya kapatın, üç adede kadar değer kaydedin ya da mevcut durumunu okuyun.

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

ParametreAçıklama
cmd İsteğe bağlı komut: onoffgetping
data1 Kaydedilecek isteğe bağlı metin veya sayı.
data2 Kaydedilecek isteğe bağlı metin veya sayı.
data3 Kaydedilecek isteğe bağlı metin veya sayı.
Veri gönder 
http://api.iotbind.com/v1/switch.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=on&data1=24.5&data2=OK
Yanıt: {"MESSAGE":"UPDATED"}
Cihazı oku 
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": ""
}

Aynı parametreler POST form alanları olarak da çalışır: method=post · Cihazın bağlı olduğunu bildirmek için şunu gönderin: cmd=ping → {"MESSAGE":"PING OK"}

Sensörler

Üç adede kadar okuma kaydedin veya en son değerleri okuyun.

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

ParametreAçıklama
cmd İsteğe bağlı komut: getping
data1 Kaydedilecek isteğe bağlı metin veya sayı.
data2 Kaydedilecek isteğe bağlı metin veya sayı.
data3 Kaydedilecek isteğe bağlı metin veya sayı.
Veri gönder 
http://api.iotbind.com/v1/sensor.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&data1=23.4&data2=41&data3=1012
Yanıt: {"MESSAGE":"UPDATED"}
Cihazı oku 
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"
}

Aynı parametreler POST form alanları olarak da çalışır: method=post · Cihazın bağlı olduğunu bildirmek için şunu gönderin: cmd=ping → {"MESSAGE":"PING OK"}

Sıvı depoları

Depo seviyesini ve sıcaklığını kaydedin, pompayı çalıştırın veya durumunu okuyun.

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

ParametreAçıklama
cmd İsteğe bağlı komut (depo pompasını açar veya kapatır): onoffgetping
level Depo seviyesi (sayı).
temperature İsteğe bağlı depo sıcaklığı (sayı).
Veri gönder 
http://api.iotbind.com/v1/tank.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=on&level=67&temperature=21
Yanıt: {"MESSAGE":"UPDATED"}
Cihazı oku 
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"
}

Aynı parametreler POST form alanları olarak da çalışır: method=post · Cihazın bağlı olduğunu bildirmek için şunu gönderin: cmd=ping → {"MESSAGE":"PING OK"}

GPS takibi

Dört adede kadar ek değerle bir konum kaydedin veya en son konumu okuyun.

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

ParametreAçıklama
cmd İsteğe bağlı komut: getping
latitude Enlem (sayı).
longitude Boylam (sayı).
data1 Kaydedilecek isteğe bağlı metin veya sayı.
data2 Kaydedilecek isteğe bağlı metin veya sayı.
data3 Kaydedilecek isteğe bağlı metin veya sayı.
data4 Kaydedilecek isteğe bağlı metin veya sayı.
Veri gönder 
http://api.iotbind.com/v1/tracking.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&latitude=24.7136&longitude=46.6753&data1=62
Yanıt: {"MESSAGE":"UPDATED"}
Cihazı oku 
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"
}

Aynı parametreler POST form alanları olarak da çalışır: method=post · Cihazın bağlı olduğunu bildirmek için şunu gönderin: cmd=ping → {"MESSAGE":"PING OK"}

MQTT

iotBind, MQTT.one hizmetiyle çalışır: bir cihaz değiştiğinde platform konularınıza yayın yapar, cihazlarınız da iotBind'a JSON mesajları yayınlar.

  1. Bir MQTT.one hesabı oluşturun ve ihtiyacınız olan konuları ekleyin.
  2. Platformda "MQTT hizmeti" bölümünü açın ve MQTT.one hesabınızı bağlayın.
  3. Cihaz ayarlarında "MQTT mesajları yayınla" seçeneğini açın ve konusunu seçin.
  4. Kartınızı MQTT.one bilgilerinizle, iotbind-<UNIQUE_ID> istemci kimliğini kullanarak broker'a bağlayın.
  5. JSON mesajlarını hesabınızda gösterilen iotbind konusuna yayınlayın.
iotbind/switch/ konusuna mesaj 
{ "key": "DEVICE_KEY", "uid": "UNIQUE_ID", "cmd": "off", "data1": "24.5" }

MQTT, MQTT özelliği içeren bir plan ve şu adreste bir hesap gerektirir: MQTT.one

Hata kodları

400Hatalı istek: adres, parametreler veya gövde geçerli değil.
401Yetkisiz: cihaz anahtarı veya benzersiz kimlik yanlış.
404Bulunamadı: istenen kaynak mevcut değil.
429Çok fazla istek: yavaşlayın veya planınızın sınırlarını kontrol edin.

Bir sonraki projeniz bir bulutu hak ediyor

Bir dakikada ücretsiz hesap oluşturun ve ilk cihazınızı bugün bağlayın.

Ücretsiz hesap oluştur Bizimle konuşun