البدء — انشر واجهة برمجة تطبيقات فريقك

يقدّم هذا الدرس نتيجة واحدة محددة: أخذ واجهة برمجة تطبيقات بناها فريقك ونشرها في كتالوج البوابة، بحيث يمكن للمستهلكين في مؤسستك اكتشافها، وقراءة مواصفتها، وربطها بتطبيقاتهم.

قبل أن تبدأ، ستحتاج إلى:

• حساب بوابة بدور إنتاج (مثل دور CI/CD، أو حساب منتج ضمن فريق خلفية) — راجع الأدوار وأنواع المستخدمين إن لم تكن متأكدًا من دورك.
• ملف مواصفة واجهة برمجة التطبيقات (OpenAPI أو ما شابه) جاهزًا للرفع.
• فريق خلفية مُعد مسبقًا لواجهة برمجة التطبيقات الخاصة بك. إن لم يكن لدى فريقك واحد بعد، اطلب من مسؤول البوابة إنشاءه، أو راجع إدارة فرقك.

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

1

سجّل الدخول

افتح عنوان البوابة الذي زوّدتك به مؤسستك وأكمل تسجيل الدخول حسب سياسة مؤسستك (غالبًا نفس حساب البريد أو تسجيل الدخول الموحّد). تنتقل إلى الصفحة الرئيسية.

2

اختر البيئة الصحيحة

افتح عنصر البيئة في الشريط العلوي واختر البيئة التي تنتمي إليها واجهة برمجة التطبيقات (مثل البوابة التي ينشر عليها فريقك). كل ما تفعله بعد ذلك — الرفع، ظهور الكتالوج — مرتبط بهذه البيئة. راجع البيئات لمعرفة علاقتها بـ Apigee وGravitee وAzure.

3

افتح واجهات برمجة التطبيقات

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

4

ارفع مواصفتك

استخدم منطقة الرفع / السحب والإفلات في صفحة واجهات برمجة التطبيقات لإضافة ملف مواصفتك. تظهر هذه المنطقة لأدوار الإنتاج والأتمتة؛ إن لم تظهر لك، تحقق من دورك مع مسؤولك. إن كانت لديك ملفات طبقات لغة، أرفقها في هذا الرفع — راجع عرض واجهة برمجة التطبيقات الخاصة بك. يمكنك تجاوز الطبقات في أول نشر.

5

تأكد أن فريقك يملكها

بعد اكتمال الرفع، افتح صفحة منتج واجهة برمجة التطبيقات الجديدة وتأكد من تعيينها إلى فريق الخلفية الخاص بك. هذا ما يتيح للمستهلكين معرفة من يتواصلون معه للتغييرات أو الحوادث. إن لم يكن التعيين قد تم بعد، أضفه من صفحة المنتج أو اطلب من مسؤول القيام بذلك.

6

تحقق من ظهورها في الكتالوج

عد إلى واجهات برمجة التطبيقات وتأكد أن منتجك يظهر الآن في القائمة لهذه البيئة، مع إمكانية عرض مواصفته.

INFO

واجهة برمجة التطبيقات الخاصة بك أصبحت الآن قابلة للاكتشاف. يمكن للمستهلكين فتحها من واجهات برمجة التطبيقات، وقراءة المواصفة، وإضافتها إلى أحد تطبيقاتهم — راجع إضافة واجهة برمجة تطبيقات إلى تطبيقك لتلك الخطوات.

الخطوات التالية

• إدارة فرقك — أضف زملاء إلى فريق الخلفية الخاص بك، أو اربطه بمجموعات الأذونات.
• المفاهيم الأساسية — كيف تتكامل البيئات والمنصات ومجموعات الأذونات والتطبيقات.
• المرجع — خريطة كاملة لمناطق الشاشة وعناصر التحكم في البوابة عندما تستكشف أبعد من هذا الدرس.