HTTP طلبات

استخدام واجهة برمجة التطبيقات HTTP/HTTPS

تتيح واجهة برمجة التطبيقات HTTP لك إرسال واستقبال الطلبات من أي خدمة أو مشروع ذكي DIY إلى منصة iotBind. عند إصدار طلب HTTP,
 يجب توقيع طلبك باستخدام مفتاح سر الخادم الخاص بالجهاز ، وتضمين معلمات الطلب واستخدامه طرق HTTP GET OR POST.
عنوان URL الأساسي لإصدار 1.0 هو:

 http://api.iotbind.com/v1/

لإنشاء مفتاح API ، انقر فوق أيقونة المفتاح. بعد إضافة الجهاز ثم انقر فوق أيقونة التحديث لإنشاء مفتاح جديد في أي وقت.  

URL API : http://api.iotbind.com/v1/switch.php
المعلمةالقيمةالوصف
الطريقة"POST" أو "GET" لأجل معرفة كيفية إرسال البيانات , يجب دائماً استخدام القيمة "post" أو "get"
UIDمعرف فريد للجهازيجب دائماً استخدامه
المفتاحالمفتاح المشفرمفتاح سر الخادم الخاص بالجهاز , يجب دائماً استخدامه 
الأمرأحد هذه:"on""off""get""ping"يجب استخدام أمر واحد فقط عند إرسال طلب إلى iotbind"on" إذا كنت تريد إرسال أمر "on" للجهاز"off" إذا كنت تريد إرسال أمر "off" للجهاز"get" إذا كنت تريد الحصول على جميع بيانات الجهاز من منصة iotBind"ping" إذا كنت تريد إرسال أمر "ping" إلى منصة iotBind لمعرفة ما إذا كان الجهاز متصلاً
data1نص أو أرقام(اختياري) استخدمه فقط لتحديث data1
data2نص أو أرقام(اختياري) استخدمه فقط لتحديث data2
data3نص أو أرقام(اختياري) استخدمه فقط لتحديث data3

مثال: إذا كنت بحاجة لإرسال أمر "on" وتحديث data1،data2،data3 عبر رابط URL "طريقة GET":

http://api.iotbind.com/v1/switch.php?method=get&key={DeviceKay}&uid={UniqueID}&cmd=on&data1={Anything}&data2={Anything}&data3={Anything}

استبدل:
{DeviceKay} = مفتاح جهاز API
{UniqueID} = معرف فريد للجهاز
{Anything} = أي بيانات تحتاجها

بيانات JSON الإخراج :

  

{ "MESSAGE":"UPDATED"}

* data1,data2,data3 هي اختيارية إذا كنت تحتاج لتحديث البيانات  

مثال: إذا كنت بحاجة للحصول على بيانات تبديل بواسطة "طريقة GET":

http://api.iotbind.com/v1/switch.php?method=get&key={DeviceKay}&uid={UniqueID}&cmd=get

استبدل:
{DeviceKay} = مفتاح جهاز API
{UniqueID} = معرف فريد للجهاز  

بيانات JSON الإخراج :

{ "MESSAGE":"PING OK"}

إذا كنت تريد إرسال أمر "ping" إلى منصة iotBind لمعرفة ما إذا كان الجهاز متصلاً عبر رابط URL "طريقة POST":
  http://api.iotbind.com/v1/switch.php  

إرسال بيانات الطلب باستخدام طريقة POST:
method=post

UID = معرف فريد للجهاز
key = مفتاح جهاز API
cmd = الأمر

بيانات JSON الإخراج :

{ "MESSAGE":"PING OK"}

Generated by IoTbind Docs on 2026-05-01 04:56