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

Node admin-api

تسمح هذه العقدة بالتفاعل مع واجهات برمجة التطبيقات المختلفة، مما يكون مفيدًا للتكامل مع الخدمات الخارجية.

إعدادات Node admin-api​

IMG2

1. الاسم​

حقل لتحديد اسم العقدة.
يتم عرض الاسم في مساحة العمل ويساعد في التعرف بسهولة على العقدة.
إذا ترك فارغًا، ستسمى العقدة admin-api.

مثال:

  • اسم العقدة: إنشاء جلسة دفع

2. النوع​

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

  • "تحديث كائن الصفحة":

  • "البحث عن جميع الكائنات في صفحات المنتجات مع الترقيم لفئة محددة":

  • "تغيير حالة صفحة المنتج":

  • "تحديث صفحة المنتج":

  • "تحديث كائن المستخدم - مسؤول":

  • "تحديث كائن مستخدم واحد":

  • "تحديث قيمة سمة كيان واحد":

  • "استلام جميع الطلبات التي تنتمي إلى كائن تخزين الطلبات":

  • "تحديث حالة طلب ينتمي إلى كائن تخزين الطلبات":

  • "تحديث جلسة الدفع":

  • "استلام كائن جلسة دفع واحدة بواسطة معرفها":

  • "إنشاء جلسة دفع":

  • "استلام جميع السجلات التي تنتمي إلى المجموعة":

  • "إنشاء سجل في المجموعة":

  • "تغيير سجل في المجموعة":

  • "حذف كائن من سجل المجموعة":

3. معلمات الاستعلام​

يستخدم هذا الحقل قالب Mustache لتشكيل بيانات الطلب بتنسيق JSON.
يمكنك استخدام البيانات من رسالة msg لاستبدال القيم في القالب.

مثال على القالب (للطريقة "استلام جميع السجلات التي تنتمي إلى المجموعة"):

 {
   "entityType": "orders",
   "entityId": "{{orderId}}",
   "langCode": "en_US",
   "offset": 0,
   "limit": 1,
   "marker": "delivery"
 }

في هذا المثال، سيتم استبدال قيمة orderId من رسالة msg.
عند استخدام قوالب Mustache، يمكنك تمرير بيانات ومعلمات معقدة ضرورية للتفاعل مع واجهة برمجة التطبيقات.

4. جسم الطلب​

يستخدم هذا الحقل قالب Mustache لتشكيل بيانات الطلب بتنسيق JSON.
يمكنك استخدام البيانات من رسالة msg لاستبدال القيم في القالب.

مثال على القالب (للطريقة "إنشاء جلسة دفع"):

 {
   "orderId": {{orderId}},
   "type": "session"
 }

في هذا المثال، سيتم استبدال قيمة orderId من رسالة msg.
عند استخدام قوالب Mustache، يمكنك تمرير بيانات ومعلمات معقدة ضرورية للتفاعل مع واجهة برمجة التطبيقات.

أمثلة على الطلبات​

المثال 1: إنشاء جلسة دفع​

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

  • النوع: إنشاء جلسة دفع
  • جسم الطلب: 
    {
      "orderId": {{orderEvent.order.id}},
      "type": "session"
    }

النتيجة:
سترسل العقدة طلبًا لإنشاء جلسة دفع باستخدام البيانات من الرسالة. ونتيجة لذلك، سيتم استلام معلومات حول جلسة الدفع الجديدة.

المثال 2: تحديث جلسة دفع​

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

  • النوع: تحديث جلسة الدفع
  • معلمات الاستعلام: 
    {
      "id": {{paymentSessionId}}
    }
  • جسم الطلب: 
    {
      "status": "{{status}}"
    }

النتيجة:
سترسل العقدة طلبًا لتحديث حالة جلسة الدفع، باستخدام القيم المقدمة paymentSessionId و status.