كيف تعمل API-dex
تعمل API-dex فوق بوابات العبور الخاصة بواجهات برمجة التطبيقات لديك وتمنح كل دور بوابة واحدة للعمل فيها. تشرح هذه الصفحة الأجزاء وكيف ينتهي تغيير على بوابة عبور واحدة ظاهرًا لمطوّر يستعرض الكتالوج.
شكل النظام
لا تحلّ API-dex محلّ Apigee أو Gravitee أو Azure API Management. تتصل بكل منها بوصفها بيئة وتعرض ما تكشفه، مثل الواجهات والمواصفات وبيانات الاعتماد، عبر واجهة متسقة واحدة ونموذج وصول واحد.
لا تمرّ حركة مرور الواجهات عبر API-dex أبدًا. يستدعي التطبيق بوابة العبور مباشرة ببيانات الاعتماد التي أصدرتها API-dex له.
خطوتا إعداد مرة واحدة، ثم تدفّقان يوميان
يقوم المسؤولون بأمرَين مرة واحدة. ثم يعمل المنتِجون والمستهلكون دون تدخّل المسؤول.
مرة واحدة، بواسطة مسؤول
- تسجيل بيئة. يربط المسؤول API-dex ببوابة عبور بتفاصيل اتصال تلك البوابة ويختبر الاتصال.
- تعريف مجموعات الأذونات. ينشئ المسؤول أنماط الوصول التي تربط الفرق بالواجهات التي يجوز لها استدعاؤها، ويربط الفرق المعنية.
كل يوم، بواسطة المنتِجين والمستهلكين
- النشر. يحمّل مُنتِج في فريق خلفية، أو حساب CI/CD، مواصفة OpenAPI إلى بيئة. تظهر الواجهة في كتالوج تلك البيئة، مملوكة للفريق.
- الاكتشاف والاشتراك. يستعرض مستهلك الكتالوج، ويقرأ المواصفة، ويضيف الواجهة إلى أحد تطبيقاته.
- استدعاء الواجهة. تُخوِّل بيانات اعتماد التطبيق، الصادرة بالصيغة التي تتوقعها بوابة العبور، الاستدعاء عند بوابة العبور.
لماذا كل شيء مقيّد ببيئة
ينتمي الكتالوج والتطبيقات وبيانات الاعتماد والإحصائيات كلها إلى البيئة المحددة في الترويسة. هذا ما يتيح لبوابة واحدة أن تمثّل عدة بوابات عبور، مثل بيئة اختبار Gravitee وبيئة إنتاج Apigee، دون خلط بياناتها. حين يبدو أن شيئًا مفقود، فالبيئة المحددة هي أول ما يُفحَص. راجع البيئات.
الظهور بحسب الدور
تعرض API-dex لكل شخص القوائم التي يسمح بها دوره فقط. يرى المستهلكون الكتالوج وتطبيقاتهم وفرقهم. ويرى المنتِجون أيضًا منطقة التحميل في صفحة APIs. ويرى المسؤولون أيضًا قسم Admin وإعدادات المؤسسة. ويختار المسؤولون كذلك الوحدات المفعّلة للمؤسسة، مثل شجرة التوثيق أو إدارة الشركات. راجع الأدوار وأنواع المستخدمين والمصفوفة الكاملة في المرجع: الأدوار والظهور.