ربط الأجهزة عبر بروتوكول الإتصال HTTP/HTTPS
يسمح بروتوكول الإتصال HTTP/HTTPS لإرسال البيانات و إستقبالها من أي جهاز أو خدمة خارجية تدعم نفس البروتوكول إلى منصة بيند بكل يسر و سهولة و بدون أي تعقيدات.
منصة بيند تدعم بروتوكل HTTP بكلا حالتيه سواء بالطبقة الأمنية HTTPS أو بدون HTTP مع تفضيل إستخدام البروتوكول بالطبقة الأمنية SSL و ذلك لتأمين البيانات من أي تطفل أو تدخل خارجي بين المنصة و الأجهزة المرتبطة
عند إرسال طلب HTTP/HTTPS ، يجب أن يتم توقيع البيانات بمفتاح تشفير خاص بالجهاز المرسل للبيانات أو الجهاز المستقبل وذلك للمصادقة عليه و التأكد من أن البيانات تصل لمنصة بيند من الجهاز المقصود و حفاظ على سرية معلومات الحساب الرئيسي للمشروع ، وأن يتم تضمين البيانات مع المفتاح المشفر في الطلب بإستخدام إحدى الطريقتين لتضمين البيانات إما POST أو GET.

عنوان بوابة الربد بإستخدام بوتوكول: (API version 1.0)
http://api.iotbind.com/v1

جميع طلبات الإتصال بمنصة بيند من الأجهزة إما لإرسال بيانات أو لطلبها يجب أن تكون مرفق معها مفتاح التشفير الخاص بالجهاز و سنرمز له في جميع التعليمات و التوجيهات القادمة بالمصطلح - api key - و هو خيار إلزامي لتحقق من هوية الجهاز المتصل و إستقبال الأوامر و البيانات منه.
لإنشاء مفتاح تشفير API key للجهاز , من خلال لوحة التحكم إضغط على ايقونة المفتاح لنفس الجهاز و من ثم إضغط على أيقون التحديث و سيتم إنشاء مفتاح التشفير و بإمكانك إنشاء مفتاح جديد كل مرة تقوم بنفس الخطوات

السويتشات و أجهزة التحكم في التشغيل

URL API : http://api.iotbind.com/v1/switch.php
المتغيرات و ترميز البيانات القيمة المرسلة التوضيح
method "POST" or "GET"  For How you want to send data ,Only Value "post" or "get"
Always use it 
uid Device UniqueID
 Always use it
key Encrypted key
 Device API secret key
Always use it 
cmd One of these:
"on"
"off"
"get"
"ping" 		only use one of these commands when you send a requests to iotbind
"on" If you want to send on Command to Device
"off" If you want to send off Command to Device
"get" If you want get all device data frome iotBind platform
"ping" If you want send ping Command to iotBind platform to learn that the device is connected
data1 Text or numbers
 (optional) Use it only for update data1
data2 Text or numbers
 (optional) Use it only for update data2
data3 Text or numbers
 (optional) Use it only for update data3

مثال : لو أردت إرسال أمر "on" للجهاز و تحديث البيانات الإضافية data1,data2,data3 مع دمج البيانات بالرابط مباشرة "GET method":
http://api.iotbind.com/v1/switch.php?method=get&key={DeviceKay}&uid={UniqueID}&cmd=on&data1={Anything}&data2={Anything}&data3={Anything}

replace:
{DeviceKay} = API Device Kay
{UniqueID} = Device UniqueID
{Anything} = any Data you need

الخرج json Data : 
{"MESSAGE":"UPDATED"}

* data1,data2,data3 هي قيم لبيانات إضافية (إختيارية) و يمكن الإستغناء عنها في حال لاتوجد حاجة لها

مثال : لو أدرت إستعراض و جلب بيانات الجهاز عن طريق الرابط مباشرة "GET method":
http://api.iotbind.com/v1/switch.php?method=get&key={DeviceKay}&uid={UniqueID}&cmd=get

replace:
{DeviceKay} = API Device Kay
{UniqueID} = Device UniqueID

الخرج json Data : 
{
    "uid": "UniqueID",
    "name": "DeviceName",
    "type": "RGB Light",
    "cmd": "on",
    "data1": "Anything",
    "data1_unit": "Anything",
    "data2": "Anything",
    "data2_unit": "Anything",
    "data3": "Anything",
    "data3_unit": "Anything"
}

مثال: لوأدرت إرسال أمر "off" للجهاز و تحديث بينات data1,data2,data3 عبر إرفاق البيانات مع الطلب "POST method":
http://api.iotbind.com/v1/switch.php

أرسل POST data مع الطلب:
method=post
uid=UniqueID
key=DeviceKay
cmd=off
data1=Anything
data2=Anything
data3=Anything

الخرج json Data : 
{"MESSAGE":"UPDATED"}

* data1,data2,data3 هي قيم لبيانات إضافية (إختيارية) و يمكن الإستغناء عنها في حال لاتوجد حاجة لها

مثال : لو أدرت إستعراض و طلب البيانات عن طريق "POST method":
http://api.iotbind.com/v1/switch.php

أرسل POST data مع الطلب:
method=post
uid=UniqueID
key=DeviceKay
cmd=get

الخرج json Data : 
{
    "uid": "UniqueID",
    "name": "DeviceName",
    "type": "RGB Light",
    "cmd": "on",
    "data1": "Anything",
    "data1_unit": "Anything",
    "data2": "Anything",
    "data2_unit": "Anything",
    "data3": "Anything",
    "data3_unit": "Anything"
}

لو أردت إرسال أمر "ping" لإعلام النظام بأن الجهاز متصل عبر "POST method":
http://api.iotbind.com/v1/switch.php

أرسل POST data مع الطلب:
method=post
uid=UniqueID
key=DeviceKay
cmd=ping

الخرج json Data : 
{"MESSAGE":"PING OK"}

لو أردت إرسال أمر "ping" لإعلام النظام بأن الجهاز متصل عبر "GET method":
http://api.iotbind.com/v1/switch.php?method=get&key={DeviceKay}&uid={UniqueID}&cmd=ping

replace:
{DeviceKay} = API Device Kay
{UniqueID} = Device UniqueID

الخرج json Data : 
{"MESSAGE":"PING OK"}




تحتاج الكود ؟

تقدر تنزل أي من الملفات البرمجية التالية و تخصصها على حسب مشروعك

Arduino firmware

NodeMCU Board
ESP8266 module

كود جلب البيانات كود إرسال البيانات

NudeMCU firmware Lua code

NodeMCU Board
ESP8266 module

كود جلب البيانات كود إرسال البيانات
تصفح جميع لغات البرمجة المدعومة

© Copyright 2024 iotBind - All Rights Reserved