Developer

Bangun di atas iotBind

API sederhana yang dirancang untuk mikrokontroler: satu URL, satu kunci perangkat, dan beberapa parameter.

Dapatkan kunci perangkat Referensi API

HTTP / HTTPS

Kirim dan baca data dengan permintaan GET atau POST dan balasan JSON.

MQTT

Publish dan subscribe melalui broker MQTT.one Anda untuk perintah instan.

Webhooks

Terima notifikasi bertanda tangan di server Anda sendiri saat sesuatu terjadi.

Mulai cepat

  1. 1

    Buat akun

    Daftar gratis dan konfirmasi alamat email Anda.

  2. 2

    Tambahkan perangkat

    Tambahkan sakelar, sensor, tangki, atau pelacak, lalu buka ikon kuncinya untuk menyalin ID unik dan kunci rahasia.

  3. 3

    Kirim permintaan pertama Anda

    Gunakan contoh di bawah ini di sketch Anda atau uji langsung di browser.

Dasar-dasar

Alamat dasar API versi 1 adalah http://api.iotbind.com/v1 (HTTPS didukung). Setiap permintaan membawa parameter berikut, baik di query string (GET) maupun sebagai kolom formulir (POST):

ParameterDeskripsi
method"get" or "post": cara parameter dikirim. Selalu wajib.
keyKunci API rahasia perangkat. Selalu wajib.
uidID unik perangkat. Selalu wajib.

Jaga kerahasiaan kunci perangkat. Jika bocor, buat kunci baru dari ikon kunci perangkat: kunci lama langsung tidak berlaku.

Sakelar

Nyalakan atau matikan sakelar, simpan hingga tiga nilai, atau baca statusnya saat ini.

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

ParameterDeskripsi
cmd Perintah opsional: onoffgetping
data1 Teks atau angka opsional untuk disimpan.
data2 Teks atau angka opsional untuk disimpan.
data3 Teks atau angka opsional untuk disimpan.
Kirim data 
http://api.iotbind.com/v1/switch.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=on&data1=24.5&data2=OK
Balasan: {"MESSAGE":"UPDATED"}
Baca perangkat 
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": ""
}

Parameter yang sama juga berlaku sebagai kolom formulir POST dengan method=post · Untuk melaporkan bahwa perangkat terhubung, kirim cmd=ping → {"MESSAGE":"PING OK"}

Sensor

Simpan hingga tiga pembacaan, atau baca nilai terbaru.

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

ParameterDeskripsi
cmd Perintah opsional: getping
data1 Teks atau angka opsional untuk disimpan.
data2 Teks atau angka opsional untuk disimpan.
data3 Teks atau angka opsional untuk disimpan.
Kirim data 
http://api.iotbind.com/v1/sensor.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&data1=23.4&data2=41&data3=1012
Balasan: {"MESSAGE":"UPDATED"}
Baca perangkat 
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"
}

Parameter yang sama juga berlaku sebagai kolom formulir POST dengan method=post · Untuk melaporkan bahwa perangkat terhubung, kirim cmd=ping → {"MESSAGE":"PING OK"}

Tangki cairan

Simpan level dan suhu tangki, kendalikan pompanya, atau baca statusnya.

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

ParameterDeskripsi
cmd Perintah opsional (menyalakan/mematikan pompa tangki): onoffgetping
level Level tangki (angka).
temperature Suhu tangki opsional (angka).
Kirim data 
http://api.iotbind.com/v1/tank.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=on&level=67&temperature=21
Balasan: {"MESSAGE":"UPDATED"}
Baca perangkat 
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"
}

Parameter yang sama juga berlaku sebagai kolom formulir POST dengan method=post · Untuk melaporkan bahwa perangkat terhubung, kirim cmd=ping → {"MESSAGE":"PING OK"}

Pelacakan GPS

Simpan posisi dengan hingga empat nilai tambahan, atau baca posisi terbaru.

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

ParameterDeskripsi
cmd Perintah opsional: getping
latitude Lintang (angka).
longitude Bujur (angka).
data1 Teks atau angka opsional untuk disimpan.
data2 Teks atau angka opsional untuk disimpan.
data3 Teks atau angka opsional untuk disimpan.
data4 Teks atau angka opsional untuk disimpan.
Kirim data 
http://api.iotbind.com/v1/tracking.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&latitude=24.7136&longitude=46.6753&data1=62
Balasan: {"MESSAGE":"UPDATED"}
Baca perangkat 
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"
}

Parameter yang sama juga berlaku sebagai kolom formulir POST dengan method=post · Untuk melaporkan bahwa perangkat terhubung, kirim cmd=ping → {"MESSAGE":"PING OK"}

MQTT

iotBind bekerja dengan layanan MQTT.one: platform melakukan publish ke topic Anda saat perangkat berubah, dan perangkat Anda melakukan publish pesan JSON ke iotBind.

  1. Buat akun MQTT.one dan tambahkan topic yang Anda butuhkan.
  2. Di platform, buka "Layanan MQTT" dan tautkan akun MQTT.one Anda.
  3. Di pengaturan perangkat, aktifkan "Publish pesan MQTT" dan pilih topic-nya.
  4. Hubungkan board Anda ke broker dengan detail MQTT.one Anda, menggunakan client ID iotbind-<UNIQUE_ID>.
  5. Publish pesan JSON ke topic iotbind yang ditampilkan di akun Anda.
Pesan ke topic iotbind/switch/ 
{ "key": "DEVICE_KEY", "uid": "UNIQUE_ID", "cmd": "off", "data1": "24.5" }

MQTT memerlukan paket dengan fitur MQTT dan akun di MQTT.one

Kode kesalahan

400Permintaan tidak valid: alamat, parameter, atau body tidak valid.
401Tidak sah: kunci perangkat atau ID unik salah.
404Tidak ditemukan: sumber daya yang diminta tidak ada.
429Terlalu banyak permintaan: kurangi kecepatan, atau periksa batas paket Anda.

Proyek Anda berikutnya layak mendapatkan cloud

Buat akun gratis dalam satu menit dan hubungkan perangkat pertama Anda hari ini.

Buat akun gratis Hubungi kami