إدارة واجهات API · Kong Dev Portal
بوابة المطورين في السعودية: مكان واحد لكتالوج واجهات API وتوثيقها ومفاتيحها وتسجيل مستخدميها
بوابة المطورين موقع إلكتروني يجد فيه من يستخدمون واجهات API لديكم ما يحتاجونه: يتصفحون الواجهات، ويقرؤون طريقة عملها، ويطلبون الوصول، ويحصلون على بيانات الدخول، دون مراسلة الفريق الذي بناها. وفي البنوك وشركات الاتصالات والجهات الحكومية في المملكة، قد تكون هي الفرق بين ضم شريك جديد في أيام وضمه يدويًا على مدى أسابيع. وتصمم إنتركي بوابات المطورين وتطلقها على Kong Dev Portal، مربوطةً ببوابة Kong Gateway التي تطبّق قواعد الوصول، وتدعمها من الرياض.
الخلاصة للإدارة
- ما هي: موقع للمطورين الذين يستخدمون واجهاتكم، من الشركاء أو من فرقكم الداخلية، يجمع الكتالوج والتوثيق والتسجيل وبيانات الدخول في مكان واحد.
- لماذا تهم: كل شريك يُضم عبر البريد وجداول البيانات يعني تكلفة وتأخيرًا وبيانات دخول لا يتابعها أحد.
- ما تستخدمه إنتركي: Kong Dev Portal، وهو جزء من Kong Konnect، من منتجات شركة Kong Inc.، إحدى الشركات الشريكة لإنتركي في التقنية.
- القرار الأول: ما الذي يجوز أن تحمله البوابة خارج مركز بياناتكم، لأن بوابة Kong الحالية مستضافة في Konnect.
- ما لا تغني عنه: بوابة API التي تطبّق قواعد الوصول، وسياسة الواجهات التي تتفق عليها فرقكم.
نظرة سريعة
| السؤال | الجواب |
|---|---|
| ما هي | موقع للخدمة الذاتية يجد فيه مستخدمو الواجهات ما يحتاجونه، ويقرؤون التوثيق، ويسجّلون تطبيقاتهم، ويحصلون على بيانات الدخول |
| من يستخدمها | الشركاء الخارجيون وشركات التقنية المالية، والجهات الحكومية الأخرى، والفرق الداخلية التي تستخدم واجهات مشتركة |
| منتج Kong | Kong Dev Portal، جزء من Kong Konnect، مربوط ببوابة Kong Gateway |
| أين تعمل | البوابة في Konnect، ويمكن تشغيل مستويات البيانات التي تنقل حركة الواجهات داخل المملكة |
| اللغة | محتوى بالعربية والإنجليزية، يُكتب ويُحدَّث معًا |
| من إنتركي | تصميم البوابة، والكتالوج والتوثيق، وقواعد التسجيل، والربط ببوابة API، والإطلاق، والدعم من الرياض |
ما بوابة المطورين، وما الأسماء التي تُعرف بها
يستخدم العملاء عدة أسماء لأشياء متقاربة، ومن المفيد التفريق بينها قبل وصول أي عرض.
- بوابة المطورين لواجهات API (API developer portal أو API portal): الموقع الموجّه للعموم أو للشركاء، وهو موضوع هذه الصفحة.
- كتالوج الواجهات (API catalog): قائمة الواجهات داخل البوابة، ولكل واجهة مالك وإصدار وحالة. والكتالوج الذي لا مالك لواجهاته يتقادم خلال أشهر.
- بوابة توثيق الواجهات (API documentation portal): بوابة تنشر التوثيق فقط، دون تسجيل أو مفاتيح. وهي خطوة أولى معقولة، لكنها محبطة إن بقيت الخطوة الأخيرة.
- بوابة المطورين الداخلية (internal developer portal): في هندسة المنصات تعني كتالوجًا لخدمات الجهة نفسها وخطوط النشر ومالكيها. وحين تكون الحاجة أن تجد الفرق الداخلية الواجهات المشتركة وتستخدمها، فإن بوابة واجهات بظهور خاص تكفي غالبًا.
وتأتي البوابة فوق إدارة واجهات API لا بديلًا عنها. فحصر الواجهات وسياسة الوصول وقواعد الإصدارات تأتي أولًا، وتشرح صفحة إدارة واجهات API هذا الترتيب.
روابط ذات صلةصفحة إدارة واجهات API
لماذا تنشر البنوك وشركات الاتصالات والجهات الحكومية في السعودية بوابة للمطورين
النمط متشابه في القطاعات كلها: جهات أكثر تريد الاتصال بأنظمتكم، والطريقة القديمة في منح الوصول لا تحتمل هذا العدد.
- البنوك وشركات التقنية المالية. تأتي المصرفية المفتوحة بأطراف ثالثة تحتاج إلى معرفة الواجهات وتسجيل تطبيقاتها والاختبار قبل الإنتاج. وتشرح صفحة المصرفية المفتوحة أين تدخل Kong في هذا العمل، وما الذي يبقى بيد برنامجكم.
- شركات الاتصالات. يريد شركاء الجملة والموزعون وعملاء المؤسسات الوصول إلى واجهات التفعيل أو الفوترة أو الرسائل، ولكل منهم حدوده وبيانات دخوله.
- الجهات الحكومية. تتبادل الجهات البيانات فيما بينها ومع شركات التكامل في القطاع الخاص. والبوابة تعطي كل مستخدم التوثيق نفسه وإجراء الطلب نفسه، مع خطوة موافقة توضح من وافق على كل وصول.
- الفرق الداخلية. في الجهات الكبيرة يُبنى التكامل نفسه مرتين لأن فريقًا لا يجد واجهة فريق آخر. والكتالوج الخاص ينهي ذلك.
وكثير من هذه الجهات يتصل أيضًا بالمنصات الوطنية، وأسئلة التخطيط لهذه التكاملات في دليل التكامل مع المنصات الرقمية السعودية.
روابط ذات صلةصفحة المصرفية المفتوحةالتكامل مع المنصات الرقمية السعودية
ما الذي تحمله بوابة المطورين، ومن يقرر كل جزء
يصف العمود الأوسط Kong Dev Portal كما توثّقه Kong حتى نوفمبر 2026. راجعوا توثيق Kong الحالي عند التخطيط، لأن المنتج يتغير.
| الجزء | ما تذكر Kong أن Dev Portal يقدمه | ما تقرره جهتكم |
|---|---|---|
| كتالوج الواجهات | واجهات تُنشر في البوابة، يتصفحها المطورون ويسجّلون فيها، ويمكن جمعها في حزم | أي الواجهات تُعرض، ومن يملك كل واجهة، وما حالتها |
| التوثيق | مواصفات الواجهات المنشورة، وصفحات تكتبونها وتعدّلونها | الأدلة المكتوبة والأمثلة وشرح الأخطاء، بالعربية والإنجليزية |
| تسجيل المطورين | تسجيل المطورين بموافقة من المسؤول أو بموافقة تلقائية | من يحق له الانضمام: أي مطور، أو الشركاء المدعوون فقط، أو الموظفون عبر منصة الهوية لديكم |
| التطبيقات والمفاتيح | تسجيل التطبيقات لكل واجهة، مع بيانات دخول يولّدها المطور ويديرها | طريقة التحقق من الهوية لكل واجهة، ومدة صلاحية بيانات الدخول |
| الربط بمنصة الهوية | التسجيل الديناميكي للعملاء (Dynamic Client Registration) مع مزود هوية مدعوم | أي منصة هوية تُصدر بيانات العملاء، ومن يديرها |
| الشكل والعنوان | صفحات وشكل ونطاق قابلة للتخصيص | هويتكم البصرية، وعنوان البوابة، واللغة التي يراها الزائر أولًا |
بوابة API هي التي تطبّق الوصول. تُصدر بوابة المطورين بيانات الدخول وتسجّل من طلب ماذا، ثم تتحقق Kong Gateway من كل استدعاء بناءً عليها. وبوابة المطورين التي لا تقف خلفها بوابة API مجرد موقع توثيق. وتشرح صفحة بوابة API ما تفعله طبقة التشغيل.
Kong Dev Portal: أين تعمل، وماذا يعني ذلك لإقامة البيانات
بوابة المطورين الحالية من Kong جزء من Kong Konnect، المنصة التي تستضيفها Kong. ويذكر توثيق الترقية من Kong أن بوابة المطورين لإصدار Enterprise لم تعد مشمولة في Kong Gateway Enterprise ابتداءً من الإصدار 3.5. لذلك يكون النموذج العملي لأي بوابة جديدة: بوابة في Konnect، مربوطة ببوابات API يمكنكم تشغيلها بأنفسكم.
وهذا الفصل مفيد في المملكة. فمستويات البيانات التي تنقل طلبات الواجهات واستجاباتها يمكن أن تعمل على بنية تحتية تشغّلونها داخل السعودية، فيبقى محتوى الطلبات فيها. أما ما تحمله بوابة المطورين فمختلف: أوصاف الواجهات، والتوثيق، وحسابات المطورين، وسجلات التطبيقات. ويحدد تصنيف بياناتكم هل يجوز أن يكون ذلك في منصة مستضافة، والقرار لفرق المخاطر والالتزام لديكم. ونتأكد من مكان تشغيل كل مكوّن من Konnect قبل الاتفاق على أي تصميم. وتقارن صفحة تطبيق Kong بين أشكال تشغيل بوابة API بإدارة ذاتية وبالنموذج الهجين.
اقرأ المزيد
وإن كانت قواعدكم لا تسمح بخروج أي شيء من البوابة عن مركز بياناتكم، فالجواب الصريح بوابة تبنونها وتستضيفونها بأنفسكم فوق بوابة API. وهذا ممكن، لكنه برنامج إضافي يحتاج إلى من يصونه لسنوات. ونخبركم بالحالة التي تنطبق عليكم قبل أن تشتروا أي شيء.
روابط ذات صلةصفحة تطبيق Kong
محتوى البوابة بالعربية والإنجليزية
البوابة ثنائية اللغة أكثر من صفحة رئيسية مترجمة. وهذه النقاط هي التي تحدد هل يستطيع المطورون الناطقون بالعربية استخدامها:
- تخطيط من اليمين إلى اليسار للصفحات العربية، مع بقاء أمثلة الكود والعناوين وJSON من اليسار إلى اليمين داخلها.
- مسرد واحد. اتفقوا مرة واحدة على المقابل العربي لكلمات مثل المستهلك والنطاق والرمز وحد الاستخدام، واستخدموه في كل مكان.
- فصل المواصفات عن الأدلة. تبقى أسماء العناصر كما هي في المواصفة، ويُكتب الشرح حولها بالعربية.
- أمثلة بالعربية. طلبات واستجابات تحمل أسماء وعناوين عربية، ليرى الشركاء كيف تنتقل البيانات المختلطة اللغة.
- إصدار اللغتين معًا. لا يُنشر إصدار جديد من أي واجهة قبل أن يكتمل توثيقه باللغتين.
ويعمل مهندسو إنتركي من الرياض بالعربية والإنجليزية، من الأحد إلى الخميس، فيكتبون مع فرقكم التوثيق العربي ويراجعونه، ويتابعون أسئلة الشركاء بعد الإطلاق باللغة التي يكتبون بها.
ما الذي تسألون عنه أي مورّد لبوابة المطورين
استخدموا هذه القائمة لتقييم أي عرض، بما في ذلك عرض إنتركي:
- أين يعمل كل جزء: البوابة، وحسابات المطورين، وبيانات الدخول، وبوابة API، كل منها باسمه.
- كيف تصل الواجهة إلى الكتالوج: تُنشر من المواصفة عبر خط النشر لديكم، لا تُنسخ يدويًا.
- من يوافق على الوصول، وأين تُسجَّل الموافقة.
- كيف تُلغى بيانات الدخول حين ينتهي عقد الشريك.
- كيف يُبلَّغ المطورون المسجلون بإيقاف إصدار من واجهة.
- من يُبقي المحتوى محدّثًا بعد الإطلاق، باللغتين.
- كيف تُحمى البوابة، ومن ذلك دخول الموظفين والشركاء. وتشرح صفحة أمن واجهات API ما تستطيع بوابة API تطبيقه وما لا تستطيع.
كيف تنفّذ إنتركي بوابة المطورين
-
الجمهور والواجهات.
لمن البوابة، وأي الواجهات تُعرض أولًا، ومن يملك كل واجهة.
-
إقامة البيانات والهوية.
ما الذي يجوز أن تحمله البوابة، وأين تعمل بوابة API، وبأي منصة هوية يدخل الموظفون والشركاء.
-
الكتالوج والتوثيق.
مواصفات تُنشر من خط النشر لديكم، وأدلة مكتوبة بالعربية والإنجليزية، ومسرد مشترك.
-
قواعد التسجيل.
التسجيل والموافقة وطريقة التحقق من الهوية والحدود لكل واجهة، وتطبّقها Kong Gateway.
-
تجربة مع مستخدمين فعليين.
يسجّل شريك واحد وفريق داخلي واحد بأنفسهم، ونعالج ما يتعثرون فيه.
-
الإطلاق والدعم.
الإطلاق، ثم الدعم من الرياض، أو خدمة مُدارة تُبقي الكتالوج وبوابة API في العمل.
ما الذي يحدد التكلفة والمدة
تُسعَّر تراخيص Kong وفق شروط Kong، إلى جانب خدمات إنتركي في بنود مستقلة، ولا يوجد سعر ثابت لأي منهما. وما يحرّك الرقمين: عدد الواجهات في الإصدار الأول، وهل مواصفاتها موجودة، وكم جمهورًا تخدمه البوابة، وهل يدخل الموظفون والشركاء عبر منصة الهوية لديكم، وحجم التوثيق المطلوب باللغتين، ومراجعة فريق الأمن. ونقدّم التقدير بعد ورشة العمل الأولى، لا قبلها.
أسئلة شائعة
هل نحتاج إلى بوابة للمطورين إذا كانت واجهاتنا لا تستخدمها إلا فرقنا الداخلية؟
غالبًا نعم، حين تستخدم أكثر من بضعة فرق واجهات مشتركة. فالبوابة الخاصة تتيح للموظفين أن يجدوا الواجهة ويقرؤوا توثيقها ويطلبوا الوصول عبر إجراء واحد، بدل السؤال هنا وهناك. ويمكن ألا يراها إلا من يدخل عبر منصة الهوية لديكم.
هل يمكن استضافة بوابة المطورين من Kong داخل السعودية؟
بوابة المطورين الحالية من Kong جزء من Kong Konnect الذي تستضيفه Kong، أما بوابة API التي تنقل حركة الواجهات فيمكن تشغيلها على بنيتكم التحتية داخل المملكة. وهل يجوز أن يكون محتوى البوابة في Konnect؟ هذا قرار يعود إلى تصنيف البيانات. وإن لم يجز، فالخيار الباقي بوابة تبنونها على بنيتكم التحتية.
كيف يُرخَّص Kong Dev Portal، وكم تكلف بوابة المطورين في المملكة؟
ترخّص Kong منصة Konnect بشروطها، ونقدّم سعرها إلى جانب خدماتنا، كلًّا في بند مستقل. وتتوقف تكلفة المشروع على عدد الواجهات في الإطلاق الأول، ووجود مواصفاتها، وعدد الجماهير، والربط بمنصة الهوية، والتوثيق باللغتين.
كم يستغرق إطلاق بوابة المطورين لشركائنا؟
يتوقف ذلك على حال واجهاتكم أكثر مما يتوقف على البوابة. فوجود المواصفات وسياسة وصول مكتوبة يختصر العمل، والواجهات غير الموثقة وسؤال إقامة البيانات المفتوح يطيلانه. ونقدّم تقديرًا للمدة بعد ورشة العمل الأولى.
هل يمكن نشر بوابة المطورين لدينا بالعربية والإنجليزية؟
نعم. صفحات Kong Dev Portal قابلة للتخصيص، فتُكتب الأدلة باللغتين، مع صفحات عربية من اليمين إلى اليسار وكود يبقى من اليسار إلى اليمين. والعمل تحريري بقدر ما هو تقني: مسرد واحد، وإصدار اللغتين معًا.
من يوافق على وصول الشريك إلى واجهاتنا عبر البوابة؟
جهتكم. يدعم Kong Dev Portal موافقة المسؤول على المطورين والتطبيقات، أو الموافقة التلقائية حيث تسمحون بها. ونضبط خطوات الموافقة التي تطلبها سياستكم، وتطبّق Kong Gateway بيانات الدخول الناتجة عنها.
التالي
صفحات ذات صلة
الخطوة التالية
خططوا بوابة المطورين لواجهاتكم
أخبرونا من سيستخدم البوابة، وعدد الواجهات التي تريدون عرضها أولًا تقريبًا، وهل لها مواصفات، وأين يجب أن تبقى بياناتكم. وسنرد عليكم بنطاق أولي والأسئلة التي يجب حسمها قبل شراء أي ترخيص.
أو مباشرةً
+966-11-2180999 [email protected]أبراج التعاونية، البرج الشمالي، الطابق السابع، طريق الملك فهد، العليا، ص.ب. ٥٦٨٣٥، الرياض ١١٥٦٤، المملكة العربية السعودية