بطاقة سريعة
طلب HTTP يحوّل المسار إلى عميل API: أي نظام له واجهة برمجية على الإنترنت يصبح خطوة في الأتمتة. المحرر بأسلوب Postman بخمس تبويبات.

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