عُقد البيانات

تتيح عُقد البيانات لنماذجك إجراء استدعاءات HTTP API أثناء تدفق النموذج. وهي غير مرئية للمستجيبين --- تُنفذ تلقائيًا ويمكنها جلب البيانات من واجهات برمجية خارجية أو التحقق من الإجابات مقابل الخادم الخلفي أو تفعيل إجراءات.

إضافة عقدة بيانات

1. افتح نموذجك في المنشئ.
2. انقر على + لإضافة سؤال جديد.
3. اختر عقدة بيانات من فئة المتقدم.
4. قم بتكوين طلب HTTP في خصائص السؤال.

التكوين

طريقة HTTP

اختر من GET أو POST أو PUT أو DELETE حسب نقطة نهاية الواجهة البرمجية.

عنوان URL

عنوان URL لنقطة النهاية المراد استدعاؤها. يدعم استيفاء المتغيرات --- استخدم {variableName} لإدراج قيم متغيرات النموذج.

مثال: https://api.example.com/users/{email}

إذا أدخل المستجيب jane@example.com في سؤال بريد إلكتروني سابق مخزّن كمتغير email، فإن الطلب الفعلي يذهب إلى https://api.example.com/users/jane@example.com.

الترويسات

كائن JSON لترويسات الطلب. يُدعم استيفاء المتغيرات هنا أيضًا.

مثال:

{
  "Authorization": "Bearer {secret.API_TOKEN}",
  "Content-Type": "application/json"
}

نص الطلب

لطلبات POST وPUT، قدم قالب نص JSON. يُدعم استيفاء المتغيرات.

مثال:

{
  "name": "{{full_name}}",
  "email": "{{email}}",
  "api_key": "{{secret.API_KEY}}",
  "source": "nueform"
}

أسرار الاتصال

لا تلصق مفتاح API مباشرة في عنوان URL أو ترويسة أو نص الطلب — بل احفظ بيانات الاعتماد كـ أسرار اتصال وأشِر إليها بالاسم.

1. في منشئ النماذج، افتح الإعدادات ← أسرار الاتصال.
2. انقر على إضافة سر، وأعطِه اسمًا (أحرف وأرقام وشرطات سفلية)، والصق القيمة.
3. أشِر إليه في عقدة بيانات كـ {secret.NAME} في عنوان URL أو الترويسات، أو {{secret.NAME}} في نص JSON.

الأسرار:

• مشفّرة في حالة السكون وتُحَل فقط على خوادمنا عند تنفيذ الطلب — ولا تُرسَل أبدًا إلى متصفح المستجيب.
• للكتابة فقط — بمجرد الحفظ، لا تُعرض قيمة السر مرة أخرى. يمكنك استبدال القيمة أو حذفها، لكن لا يمكنك عرضها.
• لكل نموذج — تنتقل مع النموذج عند تكراره، لكن تُزال عند النشر أو استخدام قالب أو تصدير النموذج (يضيف المالك الجديد أسراره الخاصة).

معالجة الاستجابة

تخزين الاستجابة

اضبط حقل متغير الاستجابة لحفظ استجابة JSON الكاملة كمتغير نموذج. يمكنك بعد ذلك الإشارة إلى هذه البيانات في الأسئلة اللاحقة باستخدام صيغة {variableName}.

مثال: إذا ضبطت متغير الاستجابة على user_data وأرجعت الواجهة البرمجية {"name": "Jane", "plan": "pro"}، يمكنك الإشارة إلى {user_data} في الأسئلة اللاحقة.

خيارات العرض

نص التحميل

خصص رسالة التحميل المعروضة أثناء تنفيذ الطلب. الافتراضي: "جارٍ التحميل..."

الوضع الصامت

فعّل الوضع الصامت لتنفيذ الطلب في الخلفية بدون مؤشر تحميل. يستمر النموذج بدون انتظار. مفيد لسيناريوهات الإرسال بدون انتظار مثل إشارات التحليلات أو مشغلات webhook.

وضع التصحيح

فعّل وضع التصحيح لعرض لوحة بتفاصيل الطلب والاستجابة الكاملة. مفيد أثناء تطوير النموذج --- عطّله قبل النشر.

بوابة التحقق

فعّل بوابة التحقق لاستخدام عقدة البيانات كمُحقق للسؤال السابق. إذا فشل طلب الواجهة البرمجية (استجابة غير 2xx)، يُمنع المستجيب من المتابعة ويُعرض له خطأ.

حالة الاستخدام: التحقق من رمز قسيمة أو التحقق من توفر البريد الإلكتروني أو التحقق من رمز الوصول مقابل الخادم الخلفي.

المهلة الزمنية

قم بتكوين مهلة الطلب بالثواني (الافتراضي: 10 ثوانٍ). إذا استغرق الطلب وقتًا أطول، يفشل ويعرض النموذج خطأ (ما لم يكن في الوضع الصامت).

أمثلة

المثال 1: التحقق من رمز قسيمة

1. أضف سؤال نص قصير يطلب رمز قسيمة (خزّن الإجابة كمتغير coupon).
2. أضف عقدة بيانات بعده مع:
   • الطريقة: GET
   • URL: https://api.yoursite.com/coupons/{coupon}
   • بوابة التحقق: مُفعّلة
   • متغير الاستجابة: coupon_data
3. إذا كان الرمز غير صالح، تُرجع الواجهة البرمجية 404 ويرى المستجيب خطأ.
4. إذا كان صالحًا، يتم تخزين معلومات الخصم في {coupon_data} للاستخدام لاحقًا.

المثال 2: إثراء بيانات المستخدم

1. أضف سؤال بريد إلكتروني (خزّن الإجابة كمتغير email).
2. أضف عقدة بيانات:
   • الطريقة: GET
   • URL: https://api.yoursite.com/users/{email}
   • الوضع الصامت: مُفعّل
   • متغير الاستجابة: user_info
3. يمكن للأسئلة اللاحقة الإشارة إلى {user_info} لملء الحقول مسبقًا أو تخصيص التجربة.

المثال 3: الإرسال إلى CRM

1. في نهاية النموذج، أضف عقدة بيانات:
   • الطريقة: POST
   • URL: https://api.yourcrm.com/leads
   • النص: {"name": "{{name}}", "email": "{{email}}", "phone": "{{phone}}"}
   • الوضع الصامت: مُفعّل
2. يتم إنشاء العميل المحتمل في CRM كجزء من تدفق النموذج --- بدون تأخير webhook.

ذو صلة

• المتغيرات --- كيف يعمل استبدال المتغيرات
• القفزات المنطقية --- التفريع الشرطي بناءً على الإجابات
• Webhooks --- بديل للتكاملات بعد الإرسال