ابنِ على iotBind

الأساسيات

العنوان الأساسي للإصدار 1 من الواجهة هو http://api.iotbind.com/v1 (ويدعم HTTPS). كل طلب يحمل المعاملات التالية، إما في الرابط (GET) أو كحقول نموذج (POST):

احتفظ بمفتاح الجهاز سراً. إذا تسرّب، ولّد مفتاحاً جديداً من أيقونة المفتاح في الجهاز، فيتوقف المفتاح القديم فوراً.

المفاتيح

شغّل المفتاح أو أطفئه، واحفظ حتى ثلاث قيم، أو اقرأ حالته الحالية.

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

الحساسات

احفظ حتى ثلاث قراءات، أو اقرأ آخر القيم.

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

احفظ موقعاً مع حتى أربع قيم إضافية، أو اقرأ آخر موقع.

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: تنشر المنصة إلى مواضيعك عندما يتغير جهاز، وتنشر أجهزتك رسائل JSON إلى iotBind.

1. أنشئ حساباً في MQTT.one وأضف المواضيع التي تحتاجها.
2. في المنصة افتح «خدمة MQTT» واربط حسابك في MQTT.one.
3. في إعدادات الجهاز فعّل «نشر رسائل MQTT» واختر موضوعه.
4. اربط لوحتك بالوسيط ببيانات حساب MQTT.one، باستخدام معرّف العميل iotbind-<UNIQUE_ID>.
5. انشر رسائل JSON إلى موضوع iotbind الظاهر في حسابك.

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

تتطلب MQTT باقة فيها ميزة MQTT وحساباً في MQTT.one

رموز الأخطاء