مساحة الطلب والبيئات
مساحة الطلب هي المكان الذي تتحوّل فيه العمليات المصمَّمة إلى نداءات حقيقية. تُرسِل الطلبات عبر العملية المحلية الرئيسية، وتعرض الاستجابات، وتدير القيم التي تتغيّر في كل تشغيل عبر البيئات والمتغيرات.
إرسال طلب
- افتح عملية في مساحة الطلب. تأتي الطريقة والمسار والمعاملات والرؤوس والجسم من المواصفة.
- أكمِل القيم التي تتطلب إدخالاً ملموساً، مثل معاملات المسار أو رمز مميز.
- أرسل. يُظهر التبويب رمز الحالة ورؤوس الاستجابة والجسم والمدة.
- أبقِ عدة طلبات في تبويبات للمقارنة أو إعادة التحقق.
يحدث التنفيذ في العملية الرئيسية لا WebView: لا تحجب قيود CORS المباشرة للمتصفح النداءات، ولا تُكشَف التفاصيل عبر لوحة شبكة المتصفح.
البيئات مقابل خوادم OAS
مرتبطة لكنها مختلفة؛ فهم الفرق يزيل مصدر ارتباك متكرر.
| البيئات المخصصة | servers OAS | |
|---|---|---|
| الموقع | إعدادات محلية للتطبيق | داخل مستند OpenAPI |
| قابلة للتعديل بالأداة | نعم | لا — عبر تصحيح المواصفة |
| الاستخدام | الرابط الأساسي الافتراضي للتبويبات والتشغيلات | روابط أساسية يعلنها العقد نفسه |
| مشتركة مع التوثيق | لا | نعم |
عندما يسرد المساعد الروابط الأساسية (env.listServers)، يُرجع أولاً البيئات المخصصة القابلة للاستخدام، ثم خوادم القراءة فقط المعلنة في المستند الحالي.
- إضافة/اختيار رابط محلي ينشئ ويفعّل بيئة مخصصة (
env.upsertServer،env.selectServer)؛ لا يعدّل المستند. - تغيير الخوادم في العقد يقترح بدلاً من ذلك تصحيح مواصفة.
هذا يُبقي روابط التصحيح الشخصية خارج العقد، بينما تدفع الخوادم المعلنة الطلبات أيضاً.
المتغيرات
تُدار المتغيرات في أربعة نطاقات.
- globals — متاحة في كل المجموعات.
- collection — تنطبق على مجموعة.
- environment — مرتبطة بالبيئة الحالية؛ دون خادم محدد، بكل الخوادم.
- local — لجلسة محلية فقط.
يسرد المساعد المتغيرات (env.listVariables، قابلة للتصفية بالنطاق) وينشئ أو يحدّث (env.setVariable، إنشاء/تحديث بالاسم والنطاق). يمكن ربط متغير بخادم محدد وله حالة نشاط خاصة. إعداد المتغيرات إجراء تطبيقي لا تغيير مستند.
من المعتاد وضع رموز الوصول أو المعرّفات المعاد استخدامها بين النداءات أو أعلام الميزات كمتغيرات.
عند غياب رابط أساسي
يحتاج الطلب رابطاً كاملاً. إذا لم توفّر servers المواصفة ولا البيئة الحالية رابطاً أساسياً، لا يخمّن التطبيق: يطلب إدخاله قبل التنفيذ. أفضل من استدعاء المضيف الخطأ صامتاً.
من الطلب المفرد إلى التدفّق
متى ما عمل نداء معزول، تكون الخطوة الطبيعية الربط لتمرير قيمة استجابة إلى الطلب التالي. هذا دور اختبارات السيناريو.
انظر أيضاً: التصميم مع المساعد、اختبارات السيناريو、الإعدادات.