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