أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
توفّر لك Apigee Edge مكانًا لتخزين مواصفات OpenAPI. يمكنك إدارة مواصفات OpenAPI، كما هو موضَّح في الأقسام التالية.
لمزيد من المعلومات حول مواصفات OpenAPI، يُرجى الاطّلاع على المقالة ما هي مواصفات OpenAPI؟
استكشاف قائمة المواصفات
للوصول إلى قائمة المواصفات، اتّبِع الخطوات التالية:
- سجِّل الدخول إلى apigee.com/edge.
- تحديد مؤسسة
- انقر على تطوير > المواصفات في قائمة التنقّل الجانبية.
يتم عرض القائمة الحالية للمواصفات والمجلدات.
كما هو موضّح في الشكل السابق، يمكنك إجراء ما يلي من قائمة المواصفات:
- إنشاء المواصفات واستيرادها
- إنشاء خادم وكيل لواجهة برمجة التطبيقات من مواصفات باستخدام معالج متعدّد الخطوات
- نظِّم مواصفاتك باستخدام المجلدات وتنقَّل بين هذه المجلدات (راجِع تنظيم المحتوى باستخدام المجلدات)
- تعديل مواصفات أو فتح مجلد من خلال النقر على صف
- إعادة تسمية أو حذف مواصفات
- البحث في قائمة المواصفات والمجلدات
إنشاء مواصفات OpenAPI جديدة
لإنشاء مواصفات OpenAPI جديدة، اتّبِع الخطوات التالية:
- انقر على تطوير > المواصفات في شريط التنقّل الجانبي.
- انقر على + مواصفات.
- انقر على مواصفات جديدة في القائمة المنسدلة. يتم فتح أداة تعديل المواصفات.
- استبدِل المواصفات النموذجية بتفاصيل مواصفات OpenAPI الخاصة بك.
راجِع مقالة إنشاء مواصفات باستخدام محرِّر المواصفات. - انقر على حفظ لحفظ المواصفات.
- أدخِل اسمًا للمواصفات عند مطالبتك بذلك.
- انقر على حفظ.
استيراد مواصفات OpenAPI
لاستيراد مواصفات OpenAPI:
- انقر على تطوير > المواصفات في شريط التنقّل الجانبي.
- انقر على + مواصفات.
- انقر على أحد الخيارات التالية من القائمة المنسدلة:
- استيراد عنوان URL لاستيراد المواصفات من عنوان URL حدِّد الاسم وعنوان URL عند مطالبتك بذلك.
- استيراد ملف لتصفُّح الدليل المحلي بحثًا عن المواصفات
تتم إضافة المواصفات إلى القائمة.
- انقر على اسم المواصفة لعرضها وتعديلها في أداة تعديل المواصفات.
راجِع إنشاء مواصفات باستخدام محرِّر المواصفات.
تعديل مواصفات OpenAPI الحالية
لفتح مواصفات OpenAPI الحالية، اتّبِع الخطوات التالية:
- انقر على تطوير > المواصفات في شريط التنقّل الجانبي.
- انقر على الصف المرتبط بالمواصفات في قائمة المواصفات.
- عدِّل المواصفات في محرِّر المواصفات.
راجِع مقالة إنشاء مواصفات باستخدام محرِّر المواصفات.
إنشاء خادم وكيل لواجهة برمجة التطبيقات من مواصفات في قائمة المواصفات
باستخدام Apigee Edge، يمكنك إنشاء خوادم وكيلة لواجهة برمجة التطبيقات من مواصفات OpenAPI التي تصمّمها وتحفظها في أداة تعديل المواصفات. ببضع نقرات فقط، ستحصل على خادم وكيل لواجهة برمجة التطبيقات في Apigee Edge مع المسارات والمعلَمات والتدفّقات الشرطية ونقاط النهاية المستهدَفة التي يتم إنشاؤها تلقائيًا. بعد ذلك، يمكنك إضافة ميزات مثل أمان OAuth والحدّ من عدد الطلبات والتخزين المؤقت.
بعد إنشاء خادم وكيل لواجهة برمجة التطبيقات من مواصفات OpenAPI، إذا تم تعديل المواصفات، عليك تعديل خادم وكيل لواجهة برمجة التطبيقات يدويًا ليعكس التغييرات التي تم تنفيذها. اطّلِع على مقالة ماذا يحدث إذا عدّلتُ مواصفات؟.
لإنشاء خادم وكيل لواجهة برمجة التطبيقات من مواصفات OpenAPI في قائمة المواصفات، اتّبِع الخطوات التالية:
- انقر على تطوير > المواصفات في قائمة التنقّل الجانبية.
- انتقِل إلى المجلد الذي يحتوي على مواصفات OpenAPI، إذا لزم الأمر.
- ضَع مؤشر الماوس على مواصفات OpenAPI التي تريد إنشاء خادم وكيل لواجهة برمجة التطبيقات لعرض قائمة الإجراءات.
- انقر على
.
يتم فتح معالج "إنشاء خادم وكيل" (Create Proxy) وتتم تعبئة صفحة "تفاصيل الخادم الوكيل" (Proxy details) مسبقًا باستخدام القيم من مواصفات OpenAPI، كما هو موضّح في الشكل التالي.
- انقروا على التالي.
- اتّبِع الخطوات المتبقية في معالج "إنشاء خادم وكيل"، كما هو موضّح في إنشاء خادم وكيل لواجهة برمجة التطبيقات من مواصفات OpenAPI. (ابدأ من الخطوة 8).
إعادة تسمية مواصفات
لإعادة تسمية مواصفات، اتّبِع الخطوات التالية:
- انقر على تطوير > المواصفات في قائمة التنقّل الجانبية.
- انتقِل إلى المجلد الذي يحتوي على المواصفات، إذا لزم الأمر.
- ضَع المؤشر فوق المواصفات التي تريد إعادة تسميتها لعرض قائمة الإجراءات.
- انقر على
. - عدِّل اسم المواصفات.
- انقر على إعادة تسمية لحفظ التعديلات أو على إلغاء للإلغاء.
نقل مواصفة إلى مجلد
يمكنك تنظيم مواصفاتك في مجلدات لتسهيل الإدارة والأمان. لنقل مواصفات إلى مجلد، يُرجى الاطّلاع على تنظيم المواصفات باستخدام المجلدات.
حذف مواصفات
يمكنك حذف مواصفات من متجر الملفات عندما لا تعود هناك حاجة إليها أو تصبح غير صالحة.
لحذف مواصفات، اتّبِع الخطوات التالية:
- انقر على تطوير > المواصفات في قائمة التنقّل الجانبية.
- ضَع المؤشر فوق المواصفة التي تريد حذفها لعرض قائمة الإجراءات.
- انقر على
. - انقر على حذف لتأكيد عملية الحذف عند ظهور الطلب.
- احذف العناصر ذات الصلة التي لم تعُد بحاجة إليها.