انتقل إلى المحتوى الرئيسي

عقدة http request

عقدة http request مصممة لتنفيذ طلبات HTTP إلى خدمات الويب الخارجية أو واجهات برمجة التطبيقات (API). تدعم العديد من طرق HTTP، وأنواع البيانات، والمصادقة، وإدارة مرنة للطلبات والاستجابات.

إعدادات عقدة http request​

IMG2

1. الاسم​

حقل لتحديد اسم العقدة.
يظهر الاسم في مساحة العمل ويساعد في التعرف بسهولة على العقدة.
إذا تركت فارغة، ستسمى العقدة http request.

مثال:

  • اسم العقدة: الحصول على بيانات الطقس

2. الطريقة​

طريقة HTTP التي ستستخدم في الطلب. يعتمد اختيار الطريقة على نوع العملية التي يجب تنفيذها.

طرق متاحة:

  • GET: الحصول على البيانات.
  • POST: إرسال البيانات.
  • PUT: تحديث البيانات.
  • DELETE: حذف البيانات.
  • PATCH: تحديث البيانات جزئيًا.
  • HEAD: الحصول على رؤوس الاستجابة.
  • OPTIONS: الحصول على معلومات حول واجهة برمجة التطبيقات.

مثال:

  • الطريقة: POST

3. الرابط​

حقل لتحديد عنوان URL ثابت سيتم إرسال الطلب إليه.
إذا كان يجب تحديد العنوان ديناميكيًا، يمكن تمريره في msg.url.

مثال:

  • الرابط: https://api.example.com/data

4. البيانات​

تحدد كيفية إضافة البيانات المدخلة إلى طلب HTTP. الخيارات المتاحة هي:

  1. تجاهل:
    لن يتم استخدام البيانات المدخلة في الطلب. سيتم تجاهل حقل msg.payload إذا كان موجودًا.

    مثال:
    إذا كان msg.payload يحتوي على كائن JSON، فلن يتم تضمينه في الطلب.

  1. إضافته إلى معلمات الاستعلام:
    سيتم تحويل البيانات من msg.payload إلى معلمات سلسلة الاستعلام (Query Parameters) وإضافتها إلى URL.

    مثال:
    إذا كان msg.payload يحتوي على:

    {
      "key1": "value1",
      "key2": "value2"
    }

    إذا كان الرابط محددًا كـ http://example.com/api، فإن الطلب النهائي سيكون:
    GET http://example.com/api?key1=value1&key2=value2.

  1. إرسالها كجسم الطلب:
    سيتم إرسال البيانات من msg.payload في جسم الطلب. هذه الخيار مناسب للطرق مثل POST وPUT وPATCH، حيث يتم غالبًا تمرير البيانات في الجسم.

    مثال:
    إذا كان msg.payload يحتوي على:

    {
      "name": "جون دو",
      "email": "john.doe@example.com"
    }

    إذا كانت طريقة الطلب هي POST، سيتم إرسال البيانات في جسم الطلب بالمحتوى المناسب.

5. الإرجاع​

تحدد كيفية معالجة العقدة للاستجابة من الخادم.

الخيارات:

  • سلسلة UTF-8: يتم تحويل الاستجابة إلى سلسلة (افتراضي).
  • Buffer: يتم إرجاع الاستجابة ككائن Buffer (مفيد للبيانات الثنائية مثل الصور أو الملفات).
  • JSON: إذا كانت استجابة الخادم بتنسيق JSON، فسيتم تحويلها تلقائيًا إلى كائن JavaScript.

مثال:

  • إذا تم اختيار JSON، فإن الاستجابة: 
    {"status": "ok", "value": 42}
    يتم تحويلها إلى: 
    msg.payload = { status: "ok", value: 42 };

6. المصادقة​

تدعم العقدة آليات المصادقة المدمجة.

المصادقة الأساسية​

  • اسم المستخدم: اسم المستخدم.
  • كلمة المرور: كلمة المرور.

رمز الحامل​

  • الرمز: رمز الوصول.

Digest​

  • اسم المستخدم: اسم المستخدم.
  • كلمة المرور: كلمة المرور.

البيانات المدخلة​

تقبل عقدة http request كائن الرسالة msg مع المعلمات:

  1. msg.url: URL للطلب (إذا لم يتم تحديده في إعدادات العقدة).
  2. msg.method: طريقة HTTP (إذا لم يتم تحديدها في إعدادات العقدة).
  3. msg.payload: جسم الطلب (يستخدم لطرق POST وPUT وPATCH).
  4. msg.headers: رؤوس طلب HTTP (كائن).

البيانات الخارجة​

ترجع العقدة كائن msg مع معلومات حول الطلب المنفذ:

  1. msg.payload: بيانات الاستجابة من الخادم.
  2. msg.statusCode: رمز حالة HTTP للاستجابة (مثل 200 أو 404).
  3. msg.headers: رؤوس الاستجابة.
  4. msg.responseUrl: URL الذي تم تنفيذ الطلب عليه.
  5. msg.error: وصف الخطأ (إذا فشل الطلب).

أمثلة الاستخدام​

مثال 1: تنفيذ طلب GET​

إعدادات العقدة:

  • الطريقة: GET
  • URL: https://api.weatherapi.com/v1/current.json?key=API_KEY&q=London

التدفق:

[inject] ---> [http request] ---> [debug]

النتيجة: ستعيد العقدة JSON مع حالة الطقس الحالية.

مثال 2: إرسال البيانات عبر POST​

إعدادات العقدة:

  • الطريقة: POST
  • URL: https://api.example.com/devices
  • البيانات: JSON

التدفق:

[function] ---> [http request] ---> [debug]

الكود في عقدة function:

msg.payload = {
    deviceId: "sensor123",
    status: "active"
};
msg.headers = { "Content-Type": "application/json" };
return msg;

النتيجة: سيتم إرسال البيانات، وستعيد العقدة استجابة الخادم.

مثال 3: URL ديناميكي ومصادقة​

إعدادات العقدة:

  • URL: (اتركه فارغًا)

التدفق:

[function] ---> [http request] ---> [debug]

الكود في عقدة function:

msg.url = "https://api.example.com/user/123";
msg.headers = { Authorization: "Bearer YOUR_TOKEN" };
return msg;

النتيجة: ستنفذ العقدة الطلب إلى URL المحدد مع رمز المصادقة.