يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
يتزايد استخدام بوابات مطوّري البرامج التي تتضمن ميزات النشر على الشبكات الاجتماعية للتواصل مع منتدى مطوّري البرامج. ويشمل ذلك عرض المحتوى الثابت، مثل مستندات واجهة برمجة التطبيقات وبنود الاستخدام، بالإضافة إلى المحتوى الديناميكي الذي يساهم به المنتدى مثل المدونات والمنتديات.
وبصفتك موفّر واجهة برمجة تطبيقات، تحتاج إلى طريقة لعرض واجهات برمجة التطبيقات الخاصة بك وتعريف المطوّرين على واجهات برمجة التطبيقات الخاصة بك والاشتراك في المطوّرين والسماح لهم بتسجيل التطبيقات. إنّ عرض واجهات برمجة التطبيقات الخاصة بك أمام المطوّرين ليس سوى جزء من عملية إنشاء منتدى ديناميكي حقًا. وتحتاج أيضًا إلى طريقة تتيح لمنتدى المطوّرين لديك تقديم الملاحظات وتقديم الدعم وطلبات الميزات وإرسال المحتوى الخاص بهم الذي يمكن لمطوّري البرامج الآخرين الوصول إليه.
توفّر لك Apigee Edge بوابة خدمات المطوّرين التي يمكنك استخدامها لإنشاء وإطلاق موقعك الإلكتروني المخصّص بهدف تقديم جميع هذه الخدمات إلى منتدى التطوير. يمكن لكل عميل Edge إنشاء بوابة مطوّري البرامج الخاصة به، إما في السحابة الإلكترونية أو داخل الشركة.
يقدم الفيديو التالي بوابة خدمات مطوّري البرامج في Apigee.
يوضِّح الشكل التالي الصفحة الرئيسية لبوابة المطوّرين التلقائية:
بوابة المطوّرين هي في الأساس نظام إدارة محتوى (CMS) يستند إلى مشروع Drupal مفتوح المصدر (http://www.drupal.org). توفّر Drupal مجموعة أساسية من الميزات على شكل وحدات تسهِّل عليك إنشاء المحتوى على المواقع الإلكترونية وإدارتها.
بشكل غير تقليدي، تتيح لك بوابة المطوّرين إنشاء مستندات حول واجهة برمجة التطبيقات، كما تتيح التدوين، وتوفّر منتديات تتضمّن سلاسل محادثات. يمكنك أيضًا تخصيص بوابة المطوّرين لاستيفاء متطلباتك الخاصة. يتيح لك التخصيص تعديل مظهر البوابة وأيضًا تعديل طريقة تفاعل المطوّرين مع البوابة.
ويمكنك استخدام قائمة Drupal لإجراء معظم التخصيص. في حال تسجيل الدخول إلى البوابة كمستخدم لديه امتيازات المشرف، ستظهر قائمة Drupal في أعلى كل صفحة بوابة:
وتتحكّم الإدارة في العملية التي يطلب فيها المطوّرون الوصول إلى البوابة، وطريقة تسجيل المطوّرين للتطبيقات التي تصل إلى واجهات برمجة التطبيقات، وطريقة تعيين أدوار وأذونات محدّدة للمطوّرين مرتبطة بواجهات برمجة التطبيقات الخاصة بك، وحالات إبطال وصول المطوّرين إلى واجهات برمجة التطبيقات.
ويمكنك أيضًا استخدام بوابة المطوّرين لضبط ميزة تحقيق الربح والتحكّم فيها. تتيح ميزة تحقيق الربح للمطوّرين إمكانية الوصول إلى ميزات "الفوترة والتقارير" و"الكتالوج والخطة" و الإعدادات الخاصة بتحقيق الربح من خلال بوابة المطوّرين.
أنواع مستخدمي البوابة
تُظهر الصورة التالية نوعين من مستخدمي البوابة:
- مطوّرو البرامج يشكّلون منتدى المستخدمين الذين ينشئون التطبيقات باستخدام واجهات برمجة التطبيقات. يستخدم مطورو التطبيقات البوابة للتعرف على واجهات برمجة التطبيقات الخاصة بك من خلال المستندات الذكية، ولتسجيل حساب على البوابة، ولتسجيل التطبيقات التي تستخدم واجهات برمجة التطبيقات، والتفاعل مع منتدى المطورين، وعرض المعلومات الإحصائية حول استخدام التطبيقات على لوحة البيانات.
-
فريق واجهة برمجة التطبيقات هو موفِّر واجهة برمجة التطبيقات الذي ينشئ محتوى البوابة ويوفِّر واجهات برمجة التطبيقات
لمطوّري التطبيقات، ويوفر مستندات واجهة برمجة التطبيقات، كما يوفّر آلية
للمطوّرين لتسجيل التطبيقات والحصول على مفاتيح واجهة برمجة التطبيقات. ينفّذ فريق واجهة برمجة التطبيقات الإعدادات الأساسية لبوابة المطوّرين لتنفيذ ما يلي:
- ضبط الطلبات التلقائية أو اليدوية لمفاتيح واجهة برمجة التطبيقات
- الاحتفاظ بوثائق واجهة برمجة التطبيقات والمنتديات والمدونات، وتعديل جميع التغييرات بشكل اختياري
- التعامل مع تعليقات المستخدمين والإشراف على المنتدى
- فرض التحكم في الوصول المستند إلى الدور (RBAC) للتحكم في الوصول إلى الميزات على البوابة. على سبيل المثال، يمكن للمشرف تفعيل عناصر التحكّم للسماح لمستخدم مسجَّل بإنشاء مشاركات في المنتدى أو استخدام وحدات تحكّم تجريبية.
- خصِّص الإشعارات عبر البريد الإلكتروني لكل من المشرفين والمطوّرين لإنشاء حسابات المستخدمين وموافقتهم.
- تخصيص نماذج الويب مثل صفحات "التواصل معنا"
لا يظهر في هذا الشكل أنه من النوع الثالث من مستخدمي البوابة، وهو مدير منتجات واجهة برمجة التطبيقات. يتولى مدير منتجات واجهة برمجة التطبيقات مسؤولية تحديد طريقة إنشاء فريق واجهة برمجة التطبيقات للبوابة، بما في ذلك:
- تحديد كيفية تضمين واجهات برمجة التطبيقات في المنتجات
- تحديد قواعد الموافقة على التطبيق
- إذا كانت ميزة "تحقيق الربح" مفعّلة على المنصة، سيتم تحديد خطط الأسعار والفوترة لمنتجات واجهة برمجة التطبيقات. للمزيد من المعلومات حول "تحقيق الربح"، يُرجى الاطّلاع على مقالة نظرة عامة على تحقيق الربح.
تخصيص بوابة المطوّرين
بصفتك موفّرًا لواجهة برمجة تطبيقات، عليك التفكير في كيفية تخصيص بوابة المطوّرين لتلائم واجهات برمجة التطبيقات على أفضل نحو ولتوفير المعلومات اللازمة لمنتدى المطوّرين لديك من أجل استخدام واجهات برمجة التطبيقات. وتشمل بعض الاعتبارات للبوابة المخصّصة ما يلي:
- سهولة الوصول إلى واجهات برمجة التطبيقات
- الوثائق، مثل أدلة التعليمات والمستندات المرجعية
- المحتوى الذي يساهم به المنتدى مثل المدونات ومنتديات المناقشة
- نموذج التعليمات البرمجية
- عملية اشتراك سهلة تتيح للمطوّرين والتطبيقات وواجهات برمجة التطبيقات الجديدة الموافقة بسرعة
- الحقوق وبيانات الاعتماد المُدارة
- التحكّم في الوصول بمستويات متعددة
- مظهر ومضمون يناسبان مؤسستك
تأتي البوابة محدّدة مسبقًا بإعدادات أساسية. على سبيل المثال، تم إعداد المنصة للسماح لأي مستخدم بالتسجيل كمطوّر برامج، ولكن يجب أن يوافق المشرف على كل عملية تسجيل قبل أن يتمكن المطوّر من تسجيل الدخول إلى المنصة. بعد الموافقة على التسجيل، يمكن لمطوِّر البرامج تسجيل التطبيق لطلب مفتاح واجهة برمجة التطبيقات واستخدام البوابة للوصول إلى موارد واجهة برمجة التطبيقات.
في ما يلي خطوات عملية التسجيل التلقائية:
- يتسجّل المطوّر من خلال بوابة المطوّرين. استجابةً لذلك، ترسل البوابة رسالة إلكترونية إلى المشرفين للموافقة على الحساب.
- يوافق أحد المشرفين على الحساب، ويتم إرسال رسالة إلكترونية إلى المطوّر لإعلامه بأنّه يمكنه تسجيل الدخول الآن.
- يسجّل المطوّر التطبيق ويختار منتجات واجهة برمجة التطبيقات التي يستخدمها التطبيق. واستجابةً لذلك، تُخصّص البوابة مفتاح واجهة برمجة تطبيقات فريدًا للتطبيق.
- يرسل المطوّر مفتاح واجهة برمجة التطبيقات عند تقديم طلبات إلى واجهة برمجة التطبيقات.
إنّها تجربة مبتكرة وقابلة للتخصيص بشكلٍ كبير. على سبيل المثال، يمكنك إلغاء مخطط التسجيل والتفويض التلقائي بحيث تتم الموافقة على مطوّر جديد تلقائيًا ويتم تسجيل الدخول بعد التسجيل. أو يمكنك أن تطلب من مطوّر البرامج قبول مجموعة من الأحكام والشروط ليتمكّن من تسجيل الدخول للمرة الأولى.
يمكنك أيضًا التحكم بشكل كامل في المحتوى المتوفر على بوابة المطوّرين. وتقدّم بوابة المطوّرين عيّنة من المحتوى، مثل مستندات واجهة برمجة التطبيقات ومشاركات المدوّنة ومناقشات المنتديات. ويمكنك تقديم المحتوى الخاص بك وتخصيص مظهر كل نوع من أنواع المحتوى.
لمزيد من المعلومات، يُرجى الاطّلاع على تخصيص المظهر.
إدارة بوابة المطوّرين
يستخدم المطوّرون بوابة المطوّرين الخاصة بك للوصول إلى واجهة برمجة التطبيقات واستخدامها. يؤدّي المشرفون مهام إدارة الحساب، مثل:
- تخصيص عملية تسجيل المطوّرين، بما في ذلك حقول التسجيل، وميزة اختبار CAPTCHA المُدمَجة، والموافقة التلقائية أو اليدوية
- إضافة مطوّري البرامج أو الموافقة عليهم يمكن تلقائيًا لأي مطوّر التسجيل التسجيل من خلال بوابة المطوّرين، ولكن يجب أن يوافق عليه المشرف من خلال واجهة مستخدم "بوابة مطوّري البرامج". ويمكن للمشرفين أيضًا إنشاء مطوّري برامج مباشرةً على المنصة. بعد ذلك، ترسِل البوابة رسالة إلكترونية تلقائيًا إلى المطوّر لإبلاغه بإنشاء حساب له.
- تعديل حساب مطوِّر على سبيل المثال، يمكن للمشرفين تغيير حالة حساب المستخدم من "نشط" إلى "محظور" أو تغيير معلومات الملف الشخصي للمطوّر مثل اسم الشركة.
- إزالة مطوّر برامج ويمكن للمشرفين إيقاف حساب مطوّر البرامج أو حذفه.
- تعيين الأدوار والأذونات: يمكن للمشرفين إسناد دور محدّد إلى حساب مطوّر برامج. يرتبط الدور بأذونات مختلفة، مثل إذن إنشاء الكتب أو محتوى آخر. يمكنك أيضًا تغيير الأذونات المرتبطة بدور أو إنشاء أدوار جديدة.
لمزيد من المعلومات، اطّلِع على إضافة حسابات المستخدمين وإدارتها.
ملخّص ميزات بوابة المطوّرين
ويتضمّن الجدول التالي ملخّصًا لميزات بوابة المطوّرين:
| إبراز | التفاصيل |
|---|---|
| المتصفحات المتوافقة | |
|
تسجيل المستخدم |
|
|
إدارة المستخدمين |
|
|
مظهر البوابة |
|
|
إدارة المنتدى والمحتوى |
|
|
الأذونات |
|
|
إدارة مفتاح واجهة برمجة التطبيقات |
|
|
عنوان البريد الإلكتروني |
|
|
المدوّنات |
|
|
المنتديات |
|
|
الوثائق |
|
|
القوائم |
|
|
بحث |
|
|
أداة التحقّق من الروابط |
|