العمل مع URL API في Node-RED: 10 خطوات

2024 مؤلف: John Day | [email protected]. آخر تعديل: 2024-01-30 07:37

سيعلمك هذا التوجيه كيفية استخدام URL API (http get) في node-RED. انها بسيطة عن قصد. وإذا كنت جديدًا نسبيًا على node-RED ، فهذا المثال مناسب لك. سأعلمك كيفية استخدام بيئة node-RED وما هي ، وكيفية استخدام URL API.

لأغراض التدريس ، سأستخدم NETIO 4All مقبس الطاقة الذكي ، لكن لا تقلق ، لدى NETIO عرضًا تجريبيًا رائعًا عبر الإنترنت سنستخدمه حتى لا تضطر إلى شراء أي شيء.

الخطوة 1: URL API

* لأغراض التدريس ، سأشرح باستخدام مقبس الطاقة الذكي NETIO 4All

يتم تقسيم سلسلة الأحرف التي يتلقاها جهاز NETIO في عنوان URL إلى أوامر فردية ثم يقوم الجهاز بعد ذلك بتعيين مخرجاته على الحالات المطلوبة وفقًا لرقم الإجراء.

الإجراءات مع الإخراج:

• 0 = إخراج مغلق (إيقاف)
• 1 = الإخراج قيد التشغيل (تشغيل)
• 2 = الإخراج مغلق لفترة قصيرة (إيقاف قصير)
• 3 = الإخراج قيد التشغيل لفترة قصيرة (تشغيل قصير)
• 4 = تم تبديل الإخراج من حالة إلى أخرى (تبديل)
• 5 = حالة الإخراج دون تغيير (بدون تغيير)

مثال على واجهة برمجة تطبيقات URL (لتبديل حالة الإخراج 1):

netio-4all.netio-products.com:8080/netio.cgi؟pass=netio-psw&output1=4

الخطوة 2: Node-RED

ولكن ما هي العقدة الحمراء؟

Node-RED هي أداة برمجة لتوصيل الأجهزة وواجهات برمجة التطبيقات والخدمات عبر الإنترنت معًا بطرق جديدة ومثيرة للاهتمام. يوفر Node-RED محرر تدفق يعتمد على المستعرض ومجموعة واسعة من العقد والخيارات.

إنه مبني على Node. JS ، مما يجعله مثاليًا للتشغيل على أجهزة منخفضة التكلفة مثل Raspberry Pi وكذلك في السحابة.

Node-RED هي منصة شائعة لتطبيقات إنترنت الأشياء (إنترنت الأشياء). يمكن نقل التدفق (أي برنامج نصي أو مشروع) بسهولة كملف تكوين json.

الخطوة 3: التدفق

والآن الجزء الرئيسي. هكذا تبدو بيئة node-RED. في الخطوة التالية سأوضح لك كيفية استيراد التدفقات.

كما ترى ، يوفر Node-RED محرر تدفق قائم على المستعرض يجعل من السهل ربط التدفقات معًا باستخدام مجموعة واسعة من العقد في اللوحة. يمكن بعد ذلك نشر التدفقات في وقت التشغيل بنقرة واحدة.

يمكن إنشاء وظائف JavaScript داخل المحرر باستخدام محرر نص منسق. تتيح لك المكتبة المدمجة حفظ الوظائف المفيدة أو القوالب أو التدفقات لإعادة استخدامها.

الخطوة 4: كيفية استيراد التدفق - الخطوة 1

في القائمة ، حدد استيراد -> الحافظة.

الخطوة 5: كيفية استيراد التدفق - الخطوة 2

ثم انسخ النص أدناه إلى الحقل المشار إليه وانقر فوق استيراد.

[{"id": "53632275.7d628c"، "type": "tab"، "label": "NETIO AN29 (URL API)"، "معطل": false، "info": ""}، {"id": "bf404b4d.c9abf8"، "type": "http request"، "z": "53632275.7d628c"، "name": "HTTP Request (GET)"، "method": "GET"، "ret": " txt "،" url ":" https://netio-4all.netio-products.com:8080/netio.cgi؟pass=&{{msg.payload}} "،" tls ":" "،" x ": 600، "y": 160، "wires":

الخطوة 6: تثبيت العقد المفقودة

يتم تحميل العقد في التدفق المحدد. من الممكن أن تظهر رسالة خطأ مع قائمة الكتل التي يتم استيرادها ولكن لم يتم تثبيتها في Node-RED حتى الآن. في هذه الحالة ، يجب تثبيت الكتل المفقودة. إذا كانت هناك عقد مفقودة ، فحدد إدارة اللوحة في القائمة.

ثم حدد تثبيت وابحث عن العقد المفقودة وقم بتثبيتها.

الخطوة 7: لوحة القيادة

لوحة القيادة هي واجهة رسومية يمكنك من خلالها تشغيل برنامجك إذا أردت.

يمكن فتح لوحة القيادة بالنقر فوق الرمز المشار إليه ، أو على عنوان خادم Node-RED مع ملحق واجهة المستخدم ، على سبيل المثال: 127.0.0.1:1880/ui

الخطوة 8: كيف تعمل في الواقع

• يتم عرض خمسة أزرار تم إنشاؤها في التدفق في لوحة المعلومات.
• بعد النقر فوق الزر Output 1 = ON في لوحة المعلومات ، يتم تعيين الحمولة على 1 (محددة في كل زر من الأزرار لتحديد الإجراء).
• تحدد عقدة محدد الإجراء السلسلة التي تتوافق مع الإجراء (حمولة الإدخال) وتنشئ سلسلة عنوان URL الناتجة للتحكم في مقبس الطاقة الذكي
• تقوم عقدة طلب HTTP (GET) بربط عنوان IP + الإجراء من قيمة حمولة الإدخال ، وترسل السلسلة الناتجة باستخدام طلب HTTP GET. يتم إرجاع استجابة الخادم (الحالة) كناتج.
• تعرض عقدة msg.payload الاستجابة من خادم HTTP الذي يعمل في جهاز netio 4All.
• وتعرض الاستجابة من عقدة الخادم استجابة الخادم في لوحة المعلومات

الخطوة 9: العقد المذكورة أعلاه وإعداداتها

الخطوة 10: مزيد من المعلومات

شكرا لك على قراءة تعليماتي. أتمنى أن تكون قد استمتعت بها وتعلمت شيئًا جديدًا.

كان هذا التوجيه بمثابة دليل سريع حول كيفية استخدام واجهة برمجة تطبيقات URL مع node-RED

للحصول على دليل مفصل انقر على الرابط أدناه.

www.netio-products.com/ar/application-notes/an29-node-red-example-of-url-api-communication-with-netio-4x

هناك أيضًا أدلة متشابهة حول الاستخدامات المختلفة لـ node-RED ، لذلك إذا كنت مهتمًا فلا تتردد في استكشاف:

العمل مع REST JSON في node-RED

www.netio-products.com/en/application-notes/an30-node-red-example-of-rest-json-comm Communication-with-netio-4x

العمل مع REST XML في node-RED

www.netio-products.com/ar/application-notes/an31-node-red-example-of-rest-xml-comm Communication-with-netio-4x

العمل مع TCP / Modbus في node-RED

قريبا.