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