القادم | API7 DevPortal - رفع كفاءة إدارة API إلى المستوى التالي
March 10, 2023
في عالم الكمبيوتر اليوم، اعتاد الناس على استخدام واجهات برمجة التطبيقات (APIs) كوسيلة لتبادل المعلومات بين تطبيقات البرمجيات. سواء كنت تتحقق من تحديثات الطقس على هاتفك، أو تتصفح لحظات WeChat، أو تتفاعل مع ChatGPT، كل هذه الإجراءات أصبحت ممكنة بفضل واجهات برمجة التطبيقات. واجهات برمجة التطبيقات هي مجموعة من الاتفاقيات التواصلية التي تحدد كيفية تفاعلك (أو برمجيتك) مع خدمة البرمجيات المستهدفة.
إدارة دورة حياة واجهات برمجة التطبيقات بالكامل
مع نمو الشركة، يمكن أن يزداد عدد واجهات برمجة التطبيقات التي تستخدمها بسرعة. عدم إدارة هذه الواجهات بشكل صحيح يمكن أن يؤدي إلى عدد من المشكلات مثل زيادة تكاليف التعاون بين الأفراد، وعدم استقرار الخدمة، وضعف الأمان. لمعالجة هذه المخاوف، تم تطوير مفهوم إدارة دورة حياة واجهات برمجة التطبيقات بالكامل لتوفير نهج شامل لإدارة واجهات برمجة التطبيقات.
يمكن تقسيم دورة حياة واجهة برمجة التطبيقات إلى مراحل مختلفة من التصميم إلى التقاعد، وتتكون عادة من ثلاث مراحل: التخطيط والتصميم، التنفيذ، والإدارة.
التخطيط والتصميم
كمهندسين، نؤكد دائمًا على أهمية تصميم الحلول قبل كتابة الكود، وواجهات برمجة التطبيقات ليست استثناء. يجب أن نحدد الغرض من واجهة برمجة التطبيقات بناءً على متطلبات العمل ونترجم لغة الأعمال إلى مصطلحات تقنية باستخدام المكدس التقني ذي الصلة.
عادةً ما يدور التخطيط والتصميم لواجهات برمجة التطبيقات حول التوثيق. على سبيل المثال، عند تصميم واجهة برمجة تطبيقات RESTful، يجب أن يتضمن توثيق واجهة برمجة التطبيقات المعلومات التالية:
- وصف وظيفة واجهة برمجة التطبيقات
- عنوان URL المقابل لواجهة برمجة التطبيقات
- طريقة طلب HTTP
- وصف (وقيود) معلمات الطلب، جسم الطلب، ورؤوس الطلب
- رموز حالة الاستجابة المحتملة ووصف جسم الاستجابة
تم إجراء الكثير من الأبحاث حول كيفية كتابة توثيق واجهة برمجة تطبيقات واضح وشامل، والنهج الشائع حاليًا هو استخدام مواصفات OpenAPI V3.
في العالم الحقيقي، غالبًا ما يتضمن التخطيط والتصميم لواجهات برمجة التطبيقات التعاون بين عدة أفراد. لتلبية هذه الحاجة، ظهرت العديد من المنصات المخصصة لتخطيط وتصميم واجهات برمجة التطبيقات في السوق، مثل Postman. تسمح هذه الأدوات للمستخدمين بتصميم واجهات برمجة التطبيقات بشكل مرئي، وتوفر ميزات التعاون (غالبًا في إصداراتها المدفوعة). كما تسمح للمستخدمين باستيراد وتصدير واجهات برمجة التطبيقات بتنسيق معين للهجرة.
التنفيذ
بمجرد اكتمال تصميم واجهة برمجة التطبيقات، يمكن للمهندسين البدء في تطويرها. قد يختارون مكدسًا تقنيًا يجيدونه أو تتطلبه المنظمة لتنفيذ واجهة برمجة التطبيقات. أثناء التطوير، يمكن للمهندسين أيضًا اختبار واجهة برمجة التطبيقات عن طريق إضافة اختبارات من البداية إلى النهاية أو طلب الاختبار من فريق ضمان الجودة. بمجرد الانتهاء من التنفيذ، يمكن للمهندسين بعد ذلك التحضير لنشر واجهة برمجة التطبيقات.
مرحلة الإدارة
مقارنة بالمراحل السابقة، فإن مرحلة إدارة واجهة برمجة التطبيقات أكثر تعقيدًا حيث تشمل النشر، المراقبة، التصحيح، وتعزيز الأمان. هنا يلعب بوابة واجهة برمجة التطبيقات دورًا حاسمًا. تعريض مثيل الخدمة مباشرة بعد النشر ليس آمنًا ولا قابلًا للتوسع.
بدلاً من ذلك، تعمل بوابة واجهة برمجة التطبيقات كوسيط، حيث تقوم بتوجيه طلبات واجهة برمجة التطبيقات إلى الخدمة الفعلية. مع بوابة واجهة برمجة التطبيقات، يمكن تكوين سياسات مثل الحد من المعدل لمنع زيادة تحميل خدمة واجهة برمجة التطبيقات، والمصادقة للسماح فقط للمستخدمين المصرح لهم بالوصول، والمراقبة لمراقبة حالة استدعاء واجهة برمجة التطبيقات في الوقت الفعلي. باختصار، تعد بوابة واجهة برمجة التطبيقات مكونًا أساسيًا في إدارة الأمان، قابلية التوسع، وأداء واجهة برمجة التطبيقات.
في الواقع، واجهات برمجة التطبيقات ليست ثابتة ويجب على المهندسين التكرار باستمرار على وظائفها ومعالجة أي عيوب تظهر. وبالتالي، ستنتقل واجهات برمجة التطبيقات عادةً ذهابًا وإيابًا بين مراحل التخطيط والتصميم، التنفيذ، والإدارة قبل أن يتم تقاعدها بالكامل. تضمن هذه العملية الدورية أن تظل واجهات برمجة التطبيقات حديثة وفعالة طوال دورة حياتها.
استهلاك واجهات برمجة التطبيقات
تبسط إدارة دورة حياة واجهات برمجة التطبيقات بالكامل إدارة واجهات برمجة التطبيقات من منظور منتجي واجهات برمجة التطبيقات (أي مطوري واجهات برمجة التطبيقات والمحافظين عليها). ومع ذلك، فإنها لا تعالج مشكلة استهلاك واجهات برمجة التطبيقات، أي كيفية تمكين المطورين الخارجيين (الذين قد يكونون من فرق مختلفة داخل نفس الشركة) من دمج واجهة برمجة التطبيقات بسهولة. لتمكين مطور خارجي من استدعاء واجهة برمجة التطبيقات الخاصة بك، هناك عدة قضايا تحتاج إلى معالجتها:
- القضية الأولى التي يجب معالجتها هي كيفية تمكين المطورين الخارجيين من الوصول إلى معلومات واجهة برمجة التطبيقات، بما في ذلك عناوين الوصول إلى واجهة برمجة التطبيقات، الأوصاف، قيود المعلمات، أمثلة الاستخدام، والمزيد. هذه المعلومات التفصيلية ضرورية لمساعدة المطورين الخارجيين على فهم واستخدام واجهة برمجة التطبيقات بشكل فعال.
- القضية الثانية تتعلق بحماية واجهة برمجة التطبيقات، وهي أمر بالغ الأهمية لمنتجي واجهات برمجة التطبيقات. من الضروري التأكد من أن المطورين المصرح لهم فقط يمكنهم الوصول إلى واجهة برمجة التطبيقات واستخدامها باستخدام بيانات الاعتماد الصالحة لواجهة برمجة التطبيقات.
- أخيرًا، لتقليل تكلفة التواصل والتعاون، يجب أن يكون استهلاك واجهة برمجة التطبيقات ذاتيًا قدر الإمكان.
لحل هذه القضايا وتحسين استهلاك واجهات برمجة التطبيقات، تم تقديم مفهوم بوابة المطورين.
بوابة المطورين
تمكن بوابة المطورين المطورين الخارجيين من اكتشاف واجهات برمجة التطبيقات والوصول إليها، مراجعة التوثيق التفصيلي، اختبار واجهات برمجة التطبيقات، والحصول على بيانات اعتماد واجهة برمجة التطبيقات الصالحة. تعمل كمنصة ذاتية للمطورين الخارجيين، مما يسمح لهم بالوصول إلى واجهات برمجة التطبيقات بشكل أكثر كفاءة ويقلل من العبء على منتجي واجهات برمجة التطبيقات.
تتكون بوابة المطورين عادةً من موقعين: موقع الإدارة وموقع المطورين. يستخدم موقع الإدارة من قبل منتجي واجهات برمجة التطبيقات (يشار إليهم فيما بعد باسم المسؤولين)، بينما يستخدم موقع المطورين من قبل مستهلكي واجهات برمجة التطبيقات (يشار إليهم فيما بعد باسم المطورين).
يلعب موقع الإدارة في بوابة المطورين دورًا حاسمًا في تمكين المسؤولين من إدارة إصدار وإيقاف واجهات برمجة التطبيقات بشكل فعال. فقط واجهات برمجة التطبيقات التي تم إصدارها تكون مرئية على موقع المطورين. يمكن للمسؤولين أيضًا تطبيق سياسات، مثل حدود QPS ومتطلبات المصادقة، لضمان حماية واجهات برمجة التطبيقات. بالإضافة إلى ذلك، يمكن للمسؤولين مراجعة الطلبات من موقع المطورين، بما في ذلك طلبات تسجيل حسابات المطورين وطلبات الاشتراك في واجهات برمجة التطبيقات المحددة. تقدم بعض منتجات بوابة المطورين خيارًا للمسؤولين لتخصيص مظهر موقع المطورين، مثل استبدال الشعار أو تعديل الشعار.
تم تصميم موقع المطورين لمستهلكي واجهات برمجة التطبيقات. هنا، يمكن للمطورين عرض جميع واجهات برمجة التطبيقات التي نشرها المسؤولون، بما في ذلك معلوماتها التفصيلية، والتقدم بطلب للاشتراك في واجهات برمجة التطبيقات. يمكنهم إنشاء بيانات اعتماد الوصول لواجهات برمجة التطبيقات المشتركة فيها وتعلم كيفية دمجها من خلال الرجوع إلى توثيق واجهة برمجة التطبيقات.
تدمج بعض بوابات المطورين تحليل استدعاءات واجهات برمجة التطبيقات، حيث تعرض عدد الاستدعاءات وزمن الوصول لواجهات برمجة التطبيقات المحددة من منظور المطور في موقع الإدارة. يمكن أن تكون هذه البيانات أساسًا لاتخاذ القرارات للتكرارات المستقبلية وتحسين واجهة برمجة التطبيقات، مما يساعد على تحسين أدائها.
مع استمرار تطور نظام واجهات برمجة التطبيقات، يتزايد الاهتمام بمفهوم تحقيق الربح من واجهات برمجة التطبيقات. أصبحت بوابة المطورين أداة قيمة لتحقيق الربح من واجهات برمجة التطبيقات. يمكن للمسؤولين إنشاء خطط اشتراك متعددة لواجهات برمجة التطبيقات وفرض رسوم مختلفة بناءً على الحصص المتفاوتة أو عدد استدعاءات واجهة برمجة التطبيقات.
بوابة API7 DevPortal القادمة
تلتزم API7.ai بتقديم خدمات إدارة واجهات برمجة التطبيقات التي لا مثيل لها لمستخدمينا. يسعدنا الكشف عن عرضنا الجديد، API7 DevPortal، وهو منتج بوابة مطورين شامل يتكامل بسلاسة مع حل بوابة واجهات برمجة التطبيقات على مستوى المؤسسات، API7 Enterprise، المبنية على Apache APISIX.
تم تصميم API7 DevPortal لتلبية احتياجات عملائنا، حيث يوفر ميزات مثل الاشتراك في واجهات برمجة التطبيقات وموافقة تسجيل المطورين. مع بوابة المطورين الخاصة بنا، يمكن للعملاء نشر واجهات برمجة التطبيقات التي يتم تمريرها عبر البوابة بسهولة، مما يوفر لمطوريهم معلومات مفصلة عن واجهات برمجة التطبيقات على موقع المطورين.
بالإضافة إلى ذلك، نفهم أهمية تبسيط سير العمل لتعزيز الإنتاجية ودفع نمو الإيرادات. لذلك، سيخضع API7 DevPortal لتكرارين كبيرين في المستقبل.
-
أولاً، سنقوم بالتكامل مع سير عمل الموافقة لدى عملائنا. لدى بعض عملائنا منصة موافقة موحدة لإدارة عمليات الموافقة المختلفة. نهدف إلى تمكين العملاء من استخدام API7 DevPortal دون تغيير عادات الموافقة الحالية لديهم.
-
ثانيًا، سنقوم بدعم تحقيق الربح من واجهات برمجة التطبيقات لمساعدة عملائنا على تقديم خدمات اشتراك بمستويات مختلفة للمطورين ودعم تحصيل الرسوم. سنقوم قريبًا بإطلاق API7 DevPortal في السوق.
إذا كنت مهتمًا بهذا المنتج، يرجى النقر هنا للاتصال بنا.
الخلاصة
تلعب بوابات المطورين دورًا حاسمًا في إدارة استهلاك واجهات برمجة التطبيقات، مما يمكن منتجي واجهات برمجة التطبيقات من حل مشكلات دمج واجهات برمجة التطبيقات بشكل فعال دون المساس بالأمان وتسهيل تحقيق الربح. في عالم اليوم الذي تقوده واجهات برمجة التطبيقات، من الضروري النظر في تنفيذ بوابة مطورين في استراتيجية إدارة واجهات برمجة التطبيقات لفريقك.