بطاقة سريعة
طلب HTTP هو الإجراء الذي يحوّل أتمتة كرزون من “رد آلي داخلي” إلى عميل API كامل: أي نظام له واجهة برمجية على الإنترنت — متجرك، بنكك، نظام الشحن، أو نموذج ذكاء اصطناعي خارجي — يصبح خطوة عادية في مسارك.
هذا ليس نموذجاً مبسّطاً بحقلين (رابط + طريقة). هو محرر بأسلوب Postman كامل، بخمس تبويبات.
وسائط مطلوبة: محرر طلب HTTP مفتوحاً على تبويب “المحتوى” بنوع JSON، وتبويب “الاستجابة” يعرض معاينة JSON فعلية مع ربط قيمة بالسحب أو النقر.
المسار المقترح:
/images/help/automations/action-http-request-tabs.webp
فيديو (مستحسن): دقيقة واحدة: بناء طلب GET كامل، اختباره، وربط قيمة من استجابته بحقل على العميل.الطريقة (Method)
GET · POST · PUT · PATCH · DELETE — تحدد نوع العملية على الرابط المستهدف.
التبويبات الخمسة
١. المعاملات (Params)
معاملات الرابط (Query Parameters) على شكل صفوف مفتاح/قيمة. كل صف له مفتاح تفعيل مستقل — تستطيع تجهيز معامل ثم تعطيله مؤقتاً دون حذفه، مفيد أثناء التجريب.٢. الرؤوس (Headers)
رؤوس HTTP مخصصة بنفس أسلوب مفتاح/قيمة ومفتاح التفعيل لكل صف. استخدمها لإرسالContent-Type مخصص، رموز مصادقة إضافية، أو رؤوس يطلبها النظام الخارجي تحديداً.
٣. المحتوى (Body)
٤. المصادقة (Auth)
٥. الاستجابة (Response)
هنا تختبر الطلب فعلياً وتربط نتيجته بمسارك:- اضغط إرسال لتنفيذ الطلب فعلياً بالقيم الحالية (أو قيم الاختبار).
- تظهر الاستجابة كـJSON قابل للتصفح والتوسيع.
- فعّل معالجة مسبقة بكود JavaScript على الاستجابة قبل ربطها — مفيد لتحويل بنية الاستجابة قبل الاستخدام.
- اضغط على أي قيمة داخل الاستجابة لإضافتها كـربط (Mapping) يحفظها في حقل على العميل أو في متغيرات المسار — بلا كتابة مسار JSON يدوياً.
المتغيرات الديناميكية وقيم الاختبار
كل حقل — الرابط، الرؤوس، المعاملات، المحتوى، بيانات المصادقة — يقبل متغيرات المسار ({{...}})، فتستطيع بناء طلب ديناميكي بالكامل يعتمد على بيانات العميل الحالي أو إجابات أسئلة سابقة.
عند الفشل
إن لم يرجع الطلب بحالة200 أو 201، يُسلك مخرج الفشل المخصص لهذا الإجراء إن كان موصولاً بخطوة تالية؛ إن لم يكن موصولاً، يتوقف تنفيذ المسار بخطأ صامت.
متى تستخدمه؟
مثال عملي: جلب حالة شحنة من نظام خارجي
- العميل يرسل رقم التتبع (عقدة سؤال تحفظ الإجابة في متغير).
- طلب HTTP —
GETإلى واجهة شركة الشحن، مع رقم التتبع كمعامل رابط أو داخل المسار، ومصادقة Bearer إن لزم. - اختبر الطلب بقيمة اختبار في تبويب الاستجابة قبل النشر.
- اربط حقل الحالة من الاستجابة (مثل
data.status) بمتغير مسار. - شرط: إن كانت الحالة «تم التسليم» أرسل رسالة شكر، وإلا أرسل الحالة الحالية + متابعة بعد يوم.
- وصّل مخرج الفشل برسالة: «تعذّر التحقق الآن، سيتابع معك موظف» ثم تسليم بشري.