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