أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
يمكنك استخدام الإضافات لدمج المراجع الخارجية في خوادم وكيل API. على سبيل المثال، يمكنك دمج خدمات Google Cloud Platform، مثل Google Cloud Storage. في وقت التشغيل، يستخدم خادم وكيل لواجهة برمجة التطبيقات الإضافة لتبادل الطلبات والردود مع المورد الخارجي.
إطار وقت تشغيل الإضافة
في وقت التشغيل، تعمل الإضافة كوسيط، حيث تعالج الطلبات والردود بين خادم وكيل لواجهة برمجة التطبيقات ومصدر خارجي.
في ما يلي نظرة عامة على طريقة عمل المعالجة من خلال إضافة في وقت التشغيل.
- يصل طلب العميل إلى خادم وكيل لواجهة برمجة التطبيقات، ويستمر مسار الطلب من خلال سياسات الخادم الوكيل.
- يصل مسار الطلب إلى سياسة إضافة ميزات في الخادم الوكيل الذي تم إعداده لتمرير البيانات إلى إضافة تم نشرها في البيئة. تتضمّن البيانات قيمًا ستكون مطلوبة لإرسال طلب إلى المورد الخارجي الذي يمثّله الامتداد.
- يرسل الامتداد طلبًا إلى المورد الخارجي، ثم يتلقّى ردًا.
- تنقل الإضافة ردّها إلى سياسة "وسيلة الشرح الخاصة بالإضافة"، حيث تتم معالجته بواسطة رمز وكيل.
- يستمر تدفق الطلبات عبر الخادم الوكيل إلى أن يعرض ردًا على العميل.
العمل باستخدام الإضافات
يتم تطوير كل إضافة وإعدادها مع وضع مصدر خارجي معيّن في الاعتبار. لاستخدام إضافة، يتّبع مشرف Apigee Edge ومطوّر خادم وكيل لواجهة برمجة التطبيقات الخطوات العامة التالية:
- يُعدّ مشرف المؤسسة في Apigee Edge الإضافة وينشرها. ويتم ضبطها باستخدام قيم محدّدة تناسب احتياجات النشاط التجاري. يؤدي هذا الإعداد إلى إنشاء مثيل إضافة مخصّص للاستخدام من قِبل مطوّر خادم وكيل لواجهة برمجة التطبيقات. على سبيل المثال، يمكنهم ضبط إضافة للوصول إلى حزمة معيّنة في Google Cloud Storage، بما في ذلك بيانات اعتماد المصادقة المطلوبة.
- يستخدم مطوّر الخادم الوكيل لإحدى واجهات برمجة التطبيقات إضافة تم إعدادها في خادم وكيل لواجهة برمجة التطبيقات من خلال إضافة سياسة طلب بيانات من إضافة إلى الخادم الوكيل. يحدِّد إعداد السياسة ما يلي:
- الإضافة التي تم ضبطها لاستخدامها.
- إجراءات الإضافة (يمكنك اعتبارها طلبات وظائف إلى الإضافة) التي سيتم استدعاؤها
- مَعلمات الإجراء التي سيتم تمريرها مع طلب الإجراء في وقت التشغيل، تستخدم السياسة الإضافة للوصول إلى المورد الخارجي كجزء من مسار الخادم الوكيل.
مستندات حول الإضافات
تقدّم المواضيع التالية مزيدًا من المعلومات عن الإضافات:
- للحصول على مقدمة عملية حول الإضافات، اطّلِع على البرنامج التعليمي: إضافة إضافة واستخدامها.
- للحصول على مراجع حول الإضافات المضمّنة في Apigee Edge، يُرجى الاطّلاع على نظرة عامة على مرجع الإضافات.
- للحصول على مراجع حول واجهة برمجة التطبيقات الإدارية التي يمكنك استخدامها لإضافة الإضافات وإزالتها ونشرها، اطّلِع على Extensions API.