نظرة عامة على تحديد المشاكل وحلّها في "بوابة المطوِّر" المستندة إلى Drupal

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
المعلومات

وبصفتك موفّر واجهة برمجة تطبيقات، تحتاج إلى طريقة لعرض واجهات برمجة التطبيقات الخاصة بك وتعريف المطوّرين على واجهات برمجة التطبيقات الخاصة بك والاشتراك في المطوّرين والسماح لهم بتسجيل التطبيقات. توفّر لك Apigee Edge بوابة "خدمات المطوّرين" يمكنك استخدامها لإنشاء وإطلاق موقعك الإلكتروني المخصّص بهدف تقديم هذه الخدمات إلى منتدى التطوير. لمزيد من المعلومات حول بوابات مطوّري البرامج، يمكنك الاطّلاع على ما هي بوابة المطوّرين؟

توضّح الأقسام التالية المفاهيم الأساسية التي يجب فهمها قبل تحديد المشاكل في بوابة المطوّرين وحلّها.

آلية عمل Smart Docs

يمكن استيراد مواصفات OpenAPI (JSON أو YAML) أو WADL التي تصف واجهة برمجة التطبيقات إلى Smart Docs واستخدامها لنشر المستندات المرجعية لواجهة برمجة التطبيقات على بوابتك. تظهر المستندات المرجعية لواجهة برمجة التطبيقات تلقائيًا ضمن علامة تبويب واجهات برمجة التطبيقات على البوابة. يكتشف المطوّرون مستندات واجهة برمجة التطبيقات من خلال البوابة، ويمكنهم تقديم طلبات مباشرة بشأن واجهة برمجة التطبيقات. بما أنّ طلبات البيانات من واجهة برمجة التطبيقات تصدر من متصفّح، يجب توفير دعم مشاركة الموارد المتعدّدة المصادر (CORS) لضمان نجاحها. يتم توفير دعم CORS من خلال الخادم الوكيل "smartdocs" في Edge (في مؤسسة "VALIDATE") الذي يعمل كخادم وكيل لجميع طلبات Smart Docs إلى نقطة النهاية المقصودة. يتم إنشاء خادم "Smartdocs" عند تثبيت Smart Docs.

مثال:

يتم عرض عنوان URL لخادم وكيل Smartdocs كخاصية قابلة للضبط في الإعدادات -> Smart Docs -> عنوان URL لخادم وكيل Smart Docs. قد تحتاج إلى تعديل عنوان URL هذا إذا كانت واجهة برمجة التطبيقات على شبكة خاصة وتتعذّر تنفيذ طلبات البيانات المباشرة من واجهة برمجة التطبيقات التي تستخدم "مستندات Google الذكية" من البوابة.


كيفية تواصل بوابة المطوّر مع Edge

تخزِّن بوابة المطوّرين معظم المعلومات التي تعرضها من Edge وتستردها، بما في ذلك Smartdocs والمطوّرون والمنتجات وتطبيقات المطوّرين. يمكن ضبط معلومات مؤسسة Edge وبيانات اعتماد devadmin باستخدام أمر القائمة Configuration (ضبط) -> Devدخل (بوابة الويب الخاصة بمطوّر البرامج).

ولمزيد من المعلومات، يُرجى الاطّلاع على التواصل بين البوابة وEdge.