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

من خلال إنشاء رابط URL وإرساله، يخبر التطبيق الآخرين بأن يتودوا عليهم الرجوع وإرسال البيانات إلى هذا الرابط.

هذا مريح لاستقبال البيانات من أي مكان وأي شخص. ومع ذلك، كما هو موضح في الاسم، فإن الرابط هو رابط لمرة واحدة فقط. ستحتاج إلى إنشاء رابط جديد لكل استقبال مستقبلي للبيانات. ينتهي صلاحية الرابط بعد الاستخدام أو انتهاء الوقت (5-60 دقيقة، الافتراضي: 10 دقائق).

يتكون رابط لمرة واحدة من 3 أجزاء،

الجزء | الوصف

المعلمات (اختياري) | لاستقبال البيانات وربطها بحقول التطبيقات

نماذج الويب (اختياري) | لجمع معلومات إضافية عبر نموذج إلكتروني

صفحة الويب | عرض رسائل التأكيد للأجزاء السابقة واستدعاء تدفق فرعي

ملاحظة - أقسام المعاملات ونماذج الويب اختيارية. يمكنك أن يكون لديك رابط لمرة واحدة فقط يستقبل البيانات أو يجمع البيانات فقط عبر النموذج.

اتبع الخطوات من 1 إلى 5 في لقطة الشاشة أعلاه لتعديل رابط المرة الواحدة.

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

يمكنك تعبئة حمولة JSON النموذجية بواسطة

• أدخلها يدويا
• استمع إلى البيانات الفورية

على سبيل المثال، في لقطة الشاشة أعلاه، يتم إدخال بيانات JSON مع 3 قيم مدرجة يدويا.

للحصول على بيانات في الوقت الحقيقي، انقر على زر الاستماع إلى حمولة البيانات وانسخ عنوان URL العينة للاختبار. يدعم رابط المرة الواحدة كلا من طريقتي GET وPOST.

قم بإجراء اختبار مباشر وأرفق هذا الرابط النموذجي. على سبيل المثال، في متصفحك، قم بزيارة ما يلي:

سترى صفحة فارغة عند الضغط على العودة لأنك لم تصمم صفحة التأكيد بعد.

العودة إلى نافذة الاستماع إلى الحمولة بعد الاختبار والنقر على "تم":

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

انقر على Preview Payload ودعنا نربط هذه البطاقات بحقول التطبيق:

لرسم بيانات:

1. انقر على البيانات في منطقة بيانات العينة على الجانب الأيسر
2. يظهر مسار JSON على الجانب الأيمن
3. أنشئ حقلا جديدا بكتابة اسم جديد ثم انقر على الاسم الجديد أو ابحث عن حقل موجود
4. انقر على زر الإضافة للإضافة إلى قائمة الخرائط

انقر على إضافة عنصر لبدء إضافة مدخلات في نموذج الويب.

المعايير | الوصف

الاسم الفريد | فريدة في جميع مدخلات التوثيق، لا يمكنك إدخال مسافة. استخدم الخطوط السفلية أو الشرطات لفصل الكلمات

النوع | اختر السلسلة النصية للنص بدون عودة العربة، الرقم لأرقام صحيحة أو عائمة، نص للنص مع عودات العربة، اختر لإدخال المصدر الثابت أو الديناميكي

العنوان | يظهر العنوان على واجهة المستخدم

هل هو مطلوب؟ | هل هذا الإدخال ضروري؟ إذا لم يكن كذلك، قم بإيقاف التشغيل وقدم قيمة افتراضية إذا لزم الأمر

احفظ في حقل التطبيق | حدد مكان تخزين القيمة. أنشئ حقل تطبيق جديد هنا بكتابة اسم حقل جديد واختيار نوع حقل في النافذة المنبثقة، أو البحث عن حقل موجود

العنصر المؤقت | تظهر الرسالة الرمادية في صندوق الإدخال

الوصف | يظهر الموجه الأسود تحت مربع الإدخال

أضف عدد المدخلات التي تحتاجها لنماذج الويب، واضغط على الحفظ عند الانتهاء. تحقق من منطقة المعاينة .

صمم صفحة ويب بسيطة لعرض رسائل التأكيد.

اختر وقت انتهاء صلاحية الرابط لرابطك لمرة واحدة من 5 دقائق إلى 60 دقيقة. افتراضيا، ينتهي صلاحية الرابط خلال 10 دقائق.

وأخيرا، اختر تدفقا فرعيا ليتم تشغيله بعد عرض صفحة الويب.

عادة، نطلق محفزا في هذا التدفق الفرعي، لإبلاغ روبوتات الدردشة بالتحديث.

استخدم خطوة إجراء لإنشاء الرابط وحفظه في حقل تطبيق لإرساله لاحقا.