ما هي بوابة API؟ المعنى والوظائف والأمثلة

تخيّلوا مكتب الاستقبال في مبنى إداري كبير. لا يتجه الزائر مباشرةً إلى الطابق الذي يريده، بل يقف عند مكتب واحد ويعرّف بنفسه ثم يُوجَّه إلى المكان الصحيح، ولا حاجة إلى حارس في كل طابق. وبوابة API تؤدي الدور نفسه في البرمجيات: يرسل تطبيق الجوال أو الموقع أو نظام الشريك أو تطبيق داخلي آخر طلبه إلى عنوان واحد، وتحدد البوابة الخدمة التي يجب أن تجيب عنه.

يجيب موزّع الأحمال (load balancer) عن سؤال: «أي نسخة من هذه الخدمة تستقبل الطلب؟». وتجيب بوابة API عن سؤال آخر: «هل يحق لهذا المستدعي أن يرسل هذا الطلب، وأي خدمة تتولاه؟». وبينهما تداخل، فكثير من البوابات توزّع الحمل، وكثير من موزّعات الأحمال تقرأ المسارات. لكن الفرق في الجهة المستدعية: فالبوابة تعرف أن هذا الاستدعاء من شريك محدد له حد محدد، وموزّع الأحمال لا يعرف ذلك في الغالب.

تضع شبكة الخدمات (service mesh) وكيلًا صغيرًا بجوار كل خدمة، فتُشفَّر الاستدعاءات بين الخدمات وتُعاد محاولتها وتُقاس بالطريقة نفسها دون تعديل شيفرة الخدمات. وهي موجهة إلى الحركة داخل المنصة، بينما البوابة موجهة إلى الباب الأمامي. والخدمات القليلة نادرًا ما تحتاج إلى شبكة خدمات، أما الخدمات الكثيرة على Kubernetes فقد تبرّر الاثنتين. وتشرح صفحة شبكة الخدمات متى تستحق الشبكة كلفة تشغيلها.

روابط ذات صلةصفحة شبكة الخدمات

• الخادم الخلفي لتطبيق جوال: يستدعي التطبيق عنوانًا واحدًا، وتتحقق البوابة من رمز المستخدم ثم ترسل كل استدعاء إلى خدمة الحسابات أو الطلبات أو الدفع.
• واجهات الشركاء والمصرفية المفتوحة: لكل شريك بيانات دخول وحدود خاصة به. وتتناول صفحة المصرفية المفتوحة هذه الحالة.
• الخدمات المصغّرة: عشرات الخدمات الصغيرة تتشارك مكانًا واحدًا للتحقق من الهوية والحدود.
• حركة الذكاء الاصطناعي: تمر الاستدعاءات إلى النماذج اللغوية ببوابة تطبّق حدود استهلاك الرموز وقواعد التعليمات، كما في صفحة Kong AI Gateway.

روابط ذات صلةصفحة المصرفية المفتوحةصفحة Kong AI Gateway

قد لا يحتاج تطبيق واحد يستدعي خدمة واحدة، دون أي جهة خارجية، إلى بوابة بعد. والبوابة لا تجعل الخدمة غير الآمنة آمنة: فضعف التحقق من الصلاحيات داخل الخدمة، والردود التي تعيد بيانات أكثر من اللازم، والمكتبات التي لم تُحدَّث، كلها تُعالج في الخدمة نفسها. وحصر الواجهات وكتابة من يحق له استدعاء ماذا يسبقان عادةً اختيار المنتج، وهذا العمل هو إدارة واجهات API، والبوابة هي المكان الذي تُطبَّق فيه.

روابط ذات صلةإدارة واجهات API

تطبّق إنتركي Kong Gateway، وهي منتج لشركة Kong Inc. إحدى الشركات التقنية الشريكة لإنتركي. وتوثّق Kong ثلاث طرق لتشغيلها: التقليدية مع قاعدة بيانات، ودون قاعدة بيانات (DB-less) مع إعدادات تُحمَّل من ملف تعريفي، والهجينة التي يحفظ فيها مستوى التحكم الإعدادات وتحمل مستويات البيانات الحركة. وبعض الإضافات خاصة بإصدار Enterprise، فيتبع الإصدار الوظائف التي تحتاجونها.

وتصمّم إنتركي البوابة، وتكتب سياساتها إعداداتٍ تخضع لإدارة الإصدارات، وتربطها بمنصات الهوية والمراقبة لديكم، وتشغّلها بعد الإطلاق. وتعرض صفحة بوابة API أشكال النشر وقائمة متطلبات يمكنكم بها تقييم أي عرض، ومنها عرضنا.

روابط ذات صلةصفحة بوابة API

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