สร้างบน iotBind

พื้นฐาน

ที่อยู่หลักของ API เวอร์ชัน 1 คือ http://api.iotbind.com/v1 (รองรับ HTTPS) ทุกคำขอต้องมีพารามิเตอร์เหล่านี้ ทั้งในสตริงคิวรี (GET) หรือเป็นฟิลด์ฟอร์ม (POST):

เก็บคีย์อุปกรณ์เป็นความลับ หากรั่วไหล ให้สร้างคีย์ใหม่จากไอคอนกุญแจของอุปกรณ์: คีย์เก่าจะหยุดทำงานทันที

สวิตช์

เปิดหรือปิดสวิตช์ จัดเก็บค่าได้สูงสุด 3 ค่า หรืออ่านสถานะปัจจุบัน

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

http://api.iotbind.com/v1/switch.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=on&data1=24.5&data2=OK

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": ""
}

พารามิเตอร์เดียวกันใช้เป็นฟิลด์ฟอร์ม POST ได้ โดยใช้ method=post · หากต้องการแจ้งว่าอุปกรณ์เชื่อมต่ออยู่ ให้ส่ง cmd=ping → {"MESSAGE":"PING OK"}

เซ็นเซอร์

จัดเก็บค่าที่อ่านได้สูงสุด 3 ค่า หรืออ่านค่าล่าสุด

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

http://api.iotbind.com/v1/sensor.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&data1=23.4&data2=41&data3=1012

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"
}

พารามิเตอร์เดียวกันใช้เป็นฟิลด์ฟอร์ม POST ได้ โดยใช้ method=post · หากต้องการแจ้งว่าอุปกรณ์เชื่อมต่ออยู่ ให้ส่ง cmd=ping → {"MESSAGE":"PING OK"}

ถังของเหลว

จัดเก็บระดับและอุณหภูมิของถัง สั่งปั๊ม หรืออ่านสถานะ

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

http://api.iotbind.com/v1/tank.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&cmd=on&level=67&temperature=21

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"
}

พารามิเตอร์เดียวกันใช้เป็นฟิลด์ฟอร์ม POST ได้ โดยใช้ method=post · หากต้องการแจ้งว่าอุปกรณ์เชื่อมต่ออยู่ ให้ส่ง cmd=ping → {"MESSAGE":"PING OK"}

การติดตาม GPS

จัดเก็บตำแหน่งพร้อมค่าเพิ่มเติมได้สูงสุด 4 ค่า หรืออ่านตำแหน่งล่าสุด

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

http://api.iotbind.com/v1/tracking.php?method=get&key=DEVICE_KEY&uid=UNIQUE_ID&latitude=24.7136&longitude=46.6753&data1=62

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"
}

พารามิเตอร์เดียวกันใช้เป็นฟิลด์ฟอร์ม POST ได้ โดยใช้ method=post · หากต้องการแจ้งว่าอุปกรณ์เชื่อมต่ออยู่ ให้ส่ง cmd=ping → {"MESSAGE":"PING OK"}

MQTT

iotBind ทำงานร่วมกับบริการ MQTT.one: แพลตฟอร์มจะ Publish ไปยังหัวข้อของคุณเมื่ออุปกรณ์เปลี่ยนแปลง และอุปกรณ์ของคุณจะ Publish ข้อความ JSON มายัง iotBind

1. สร้างบัญชี MQTT.one และเพิ่มหัวข้อที่ต้องการ
2. ในแพลตฟอร์ม เปิด "บริการ MQTT" และเชื่อมโยงบัญชี MQTT.one ของคุณ
3. ในการตั้งค่าอุปกรณ์ เปิด "Publish ข้อความ MQTT" และเลือกหัวข้อ
4. เชื่อมต่อบอร์ดกับโบรกเกอร์ด้วยข้อมูล MQTT.one ของคุณ โดยใช้ Client ID iotbind-<UNIQUE_ID>
5. Publish ข้อความ JSON ไปยังหัวข้อ iotbind ที่แสดงในบัญชีของคุณ

{ "key": "DEVICE_KEY", "uid": "UNIQUE_ID", "cmd": "off", "data1": "24.5" }

MQTT ต้องใช้แพ็กเกจที่มีฟีเจอร์ MQTT และบัญชีที่ MQTT.one

รหัสข้อผิดพลาด