الخطوة 6: نشر واجهة برمجة تطبيقات

أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

في هذه الخطوة، ستنشر واجهة برمجة تطبيقات في البوابة من خلال اتّباع الخطوات التالية:
1. إنشاء مواصفات OpenAPI
2- إنشاء وكيل لواجهة برمجة التطبيقات من مواصفة
3- إنشاء منتج لواجهة برمجة التطبيقات
4- نشر واجهة برمجة التطبيقات في البوابة

الخطوة 1: إنشاء مواصفة OpenAPI

تُعدّ كل مواصفة OpenAPI مصدرًا للحقيقة طوال دورة حياة واجهة برمجة التطبيقات. ويتم استخدام المواصفات نفسها في كل مرحلة من مراحل دورة حياة واجهة برمجة التطبيقات، بدءًا من التطوير ووصولاً إلى النشر.

لإنشاء مواصفات OpenAPI:

1. اختَر تطوير > المواصفات في شريط التنقّل الأيمن لفتح صفحة المواصفات.
2. انقر على + مواصفة > استيراد عنوان URL.
3. أدخِل المعلومات التالية في مربّع الحوار الخاص بعملية الاستيراد:
4. اسم الاستيراد: helloworld

5. عنوان URL للاستيراد: https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget.yaml

6. انقر على استيراد.

الخطوة 2: إنشاء وكيل لواجهة برمجة التطبيقات من مواصفة

أنشئ وكيل واجهة برمجة تطبيقات من مواصفات OpenAPI التي تصف واجهة برمجة التطبيقات.

لإنشاء خادم وكيل لواجهة برمجة التطبيقات من مواصفات OpenAPI:

1. في صفحة "المواصفات"، ضع المؤشر فوق مواصفة helloworld لعرض قائمة الإجراءات.
2. انقر على لإنشاء وكيل لواجهة برمجة التطبيقات من المواصفات.
   يتم فتح معالج "إنشاء وكيل" ويتم تعبئة صفحة "التفاصيل" مسبقًا باستخدام القيم من مواصفات OpenAPI.
3. عدِّل حقل الوصف على النحو التالي: وكيل واجهة برمجة التطبيقات لتطبيق "مرحبًا".
4. انقر على التالي.

5. في صفحة السياسات:

   • ضمن الأمان: التفويض، اختَر المرور (بدون تفويض).
   • ضمن الأمان: المتصفّح، اختَر إضافة عناوين CORS .

   

6. انقر على التالي.

7. في صفحة عمليات التنقّل، تأكَّد من اختيار كل العمليات وانقر على التالي.
   

8. في صفحة "المضيفون الافتراضيون"، تأكَّد من اختيار جميع المضيفين الافتراضيين وانقر على التالي.

9. في صفحة الملخّص، اختَر البيئة التي تريد النشر فيها ضمن النشر الاختياري.

   

10. انقر على إنشاء.

في صفحة "الملخّص"، ستظهر لك رسالة تأكيد بأنّه تم إنشاء الوكيل الجديد لواجهة برمجة التطبيقات بنجاح ونشره في بيئة الاختبار.

الخطوة 3: إنشاء منتج لواجهة برمجة التطبيقات

أنشئ منتج واجهة برمجة تطبيقات يحتوي على موارد واجهة برمجة التطبيقات التي تريد إتاحتها لمستخدِمي واجهة برمجة التطبيقات.

لإنشاء منتج لواجهة برمجة التطبيقات:

1. انقر على نشر > منتجات واجهة برمجة التطبيقات في شريط التنقّل الأيمن لفتح صفحة "منتجات واجهة برمجة التطبيقات".
2. انقر على + منتج واجهة برمجة التطبيقات.
   تظهر صفحة "المنتج الجديد".
3. أدخِل تفاصيل المنتج لمنتج واجهة برمجة التطبيقات.
   ملاحظة: يتم عرض حقلَي "الاسم المعروض" و"الوصف" في البوابة تلقائيًا عند نشر منتج واجهة برمجة التطبيقات. يمكنك تعديل القيم في الخطوة 4: نشر واجهة برمجة التطبيقات في البوابة.
   

   الحقل	القيمة
   الاسم	مرحبًا يا عالم
   الاسم المعروض	مرحبًا يا عالم
   الوصف	مثال بسيط على "مرحبًا بك في العالم"
   البيئة	اختَر البيئة التي تم نشر وكيل واجهة برمجة التطبيقات فيها.
   إذن الوصول	الملف الشخصي العلني
   الموافقة تلقائيًا على طلبات الوصول	مفعَّلة
   الحصة	(يجب ترك هذا الحقل فارغًا)
   نطاقات OAuth المسموح بها	(يجب ترك هذا الحقل فارغًا)

4. ضمن موارد واجهة برمجة التطبيقات، انقر على إضافة وكيل لتحديد وكلاء واجهة برمجة التطبيقات المطلوب إضافتهم إلى منتج واجهة برمجة التطبيقات.
   يظهر مربّع الحوار إضافة مورد واجهة برمجة التطبيقات.
5. انقر على وكيل واجهة برمجة التطبيقات (إذا لم يكن محدّدًا من قبل) واختَر Mock-Target-API في القائمة.
6. انقر على إضافة.
7. انقر على حفظ لحفظ منتج واجهة برمجة التطبيقات.

   

الخطوة 4: نشر واجهة برمجة التطبيقات في البوابة

انشر واجهة برمجة التطبيقات في منصّتك ليتمكّن عملاؤك من التعرّف عليها واستخدامها.

لنشر واجهة برمجة التطبيقات في منصتك:

1. انتقِل إلى صفحة "واجهات برمجة التطبيقات" في البوابة:
   1. انقر على النشر > البوابات في شريط التنقّل الأيمن.
   2. انقر على صف بوابتي الأولى لفتح البوابة.
   3. انقر على قائمة واجهات برمجة التطبيقات لعرض صفحة "واجهات برمجة التطبيقات".
2. انقر على +.
3. اختَر Hello World في مربّع الحوار إضافة منتج من واجهة برمجة التطبيقات إلى القائمة وانقر على التالي.
4. ضمن تفاصيل واجهة برمجة التطبيقات، اضبط الخيارات التالية:
   • اختَر منشورة (مُدرَجة في القائمة) لنشر واجهة برمجة التطبيقات في البوابة.
   • بالنسبة إلى الصورة المعروضة:
     1. انقر على اختيار صورة.
     2. انقر على home-background.jpg من قائمة الصور الحالية في مربّع الحوار اختيار صورة.
     3. انقر على اختيار.
     4. اطّلِع على الصورة ثم انقر على اختيار.
   • بالنسبة إلى الفئات، أدخِل البدء واضغط على Enter.

   اترك جميع القيم الأخرى مضبوطة على قيمها التلقائية.

5. ضمن مستندات واجهة برمجة التطبيقات، لإنشاء مستندات مرجعية لواجهة برمجة التطبيقات تلقائيًا من لقطة شاشة لمواصفات OpenAPI:
   1. اختَر مستند OpenAPI.
   2. انقر على اختيار مستند.
   3. اختَر علامة التبويب مواصفاتي (إذا لم تكن محدّدة).
   4. اختَر helloworld من قائمة المواصفات.
   5. انقر على اختيار.
6. انقر على حفظ لحفظ تفاصيل واجهة برمجة التطبيقات.

   

للاطّلاع على المستندات المرجعية لواجهة برمجة التطبيقات:

1. انقر على بوابة الإصدار العلني لعرض التغييرات في بوابة الإصدار العلني (أو أعِد تحميل بوابة الإصدار العلني إذا كانت مفتوحة في علامة تبويب أخرى).
2. انقر على واجهات برمجة التطبيقات في شريط التنقّل العلوي لعرض واجهة برمجة التطبيقات المنشورة.
3. انقر على بطاقة Hello World للاطّلاع على المستندات المرجعية لواجهة برمجة التطبيقات. جرِّب واجهة برمجة التطبيقات.

---

تهانينا! لقد أكملت البرنامج التعليمي بنجاح. هل تريد مزيدًا من المعلومات؟ انتقِل إلى إنشاء البوابة المدمجة.