أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
يسرد هذا الموضوع بعض الخصائص الأساسية لخوادم وكيل API، بالإضافة إلى روابط تؤدي إلى مزيد من المعلومات.
واجهات برمجة التطبيقات هي نقاط دخول لتطبيق ما من أجل استخدام إمكانات تطبيق آخر. يمكنك تنفيذ خوادم وكيلة لواجهة برمجة التطبيقات لإنشاء واجهات برمجة تطبيقات
في Apigee Edge، يمكنك تنفيذ خوادم وكيلة لواجهة برمجة التطبيقات من خلال ضبط منطق خادم وكيل لواجهة برمجة التطبيقات كسلسلة من الخطوات التي يتم تنفيذها استجابةً لطلب من رمز العميل. يمكنك عرض خادم وكيل لواجهة برمجة التطبيقات للعملاء من خلال تحديد نقاط نهاية تتضمّن عنوان URL مع مسارات الموارد وفعل HTTP ومتطلبات النص وما إلى ذلك.
على الرغم من أنّها تُعرف باسم خادم وكيل لواجهة برمجة التطبيقات، إلا أنّها واجهة برمجة التطبيقات من منظور رمز العميل.
للحصول على نظرة عامة حول خوادم وكيل واجهة برمجة التطبيقات، يُرجى الاطّلاع على التعرّف على واجهات برمجة التطبيقات وخوادم وكيل واجهة برمجة التطبيقات.
يمكنك ترتيب تسلسل منطق خادم وكيل API باستخدام التدفقات
في أي تطبيق، تتدفّق البيانات عبر التطبيق وفقًا لمنطق الشرط. في Apigee Edge، يتألف مسار المعالجة من تدفقات. التسلسل هو سلسلة من المراحل (أو "الخطوات") التي تشكّل مسار معالجة خادم وكيل لواجهة برمجة التطبيقات. توفّر Apigee Edge طرقًا لتطبيق المنطق والسلوك في أماكن محدّدة من العميل إلى مصدر الخلفية، ثم العودة إلى العميل.
لمزيد من المعلومات حول المسارات، يُرجى الاطّلاع على التحكّم في طريقة تنفيذ خادم وكيل باستخدام المسارات.
يمكنك الوصول إلى بيانات الحالة من خلال متغيرات التدفق التي تم إنشاؤها بواسطة خوادم وكيلة لواجهة برمجة التطبيقات
يمكن لوكيل واجهة برمجة التطبيقات الوصول إلى المتغيرات التي تمثّل حالة التنفيذ. يمكنك الوصول إلى هذه المتغيرات من XML الذي يضبط إعدادات خوادم وكيل واجهة برمجة التطبيقات والسياسات. يمكنك أيضًا الوصول إليها عند توسيع نطاق خادم وكيل لواجهة برمجة التطبيقات باستخدام لغة إجرائية، مثل Java أو JavaScript أو Python.
تحتفظ Apigee Edge بهذه المتغيرات. تتوفّر بعضها تلقائيًا، ويكون ذلك عادةً لأنّها شائعة في ما تفعله خوادم وكيل واجهة برمجة التطبيقات (مثل كونها جزءًا من طلب HTTP). يمكنك أيضًا إنشاء متغيّراتك الخاصة لتلبية متطلبات منطقية.
لمزيد من المعلومات عن المتغيرات، يُرجى الاطّلاع على إدارة حالة الخادم الوكيل باستخدام متغيرات التدفق.
يمكنك أن تطلب من خوادم وكيل API تنفيذ عمليات بشكل مشروط
كما هو الحال في معظم لغات البرمجة، يمكنك في خوادم وكيل واجهة برمجة التطبيقات تنفيذ الرمز بشكل مشروط. تستند الشروط غالبًا إلى حالة خادم وكيل واجهة برمجة التطبيقات، ويمكنك الوصول إليها من خلال متغيرات التدفق. على سبيل المثال، يمكنك وضع شرط يتحقّق من وكيل المستخدم، ثم يعالج الطلب وفقًا لذلك.
لمزيد من المعلومات حول التنفيذ الشرطي، راجِع متغيرات التدفق والشروط.
يمكنك تنفيذ معظم المنطق في خادم وكيل لواجهة برمجة التطبيقات باستخدام السياسات
يتم تجميع معظم منطق المعالجة الذي تضيفه إلى خادم وكيل لواجهة برمجة التطبيقات في شكل سياسات. السياسة هي أحد مكونات Apigee Edge التي تتضمّن منطقًا خاصًا بمجال وظيفي، مثل الأمان أو إدارة عدد الزيارات. يمكنك إعداد سياسة باستخدام XML لضبط خصائص المنطق الأساسي. يمكنك ترتيب السياسات في تسلسل من "الخطوات" ضمن مسار، وذلك لكي ينفّذ خادم وكيل واجهة برمجة التطبيقات المنطق بأفضل ترتيب لتحقيق أهداف الخادم الوكيل.
لمزيد من المعلومات حول السياسات، يُرجى الاطّلاع على مقالة ما هي السياسة؟.
يمكنك تضمين مجموعات قابلة لإعادة الاستخدام من الوظائف
عندما يتضمّن خادم وكيل API منطقًا سيتم استخدامه من مواضع متعدّدة في الرمز، مثل خوادم وكيل API الأخرى، يمكنك جمع هذا المنطق لإجراء طلبات من مواضع متعدّدة. على سبيل المثال، يمكنك تجميع منطق الأمان في تدفق مشترك تستدعيه خوادم وكيلة أخرى لواجهة برمجة التطبيقات، ما يقلّل من التكرار في جميع خوادم وكيلة لواجهة برمجة التطبيقات.
لمزيد من المعلومات حول مسارات العمل المشتركة، راجِع مسارات العمل المشتركة القابلة لإعادة الاستخدام. لمزيد من المعلومات حول ربط خوادم وكيل لواجهة برمجة التطبيقات، يُرجى الاطّلاع على ربط خوادم وكيل لواجهة برمجة التطبيقات معًا.
يمكنك تصحيح أخطاء الخادم الوكيل باستخدام أداة "التتبُّع".
تتضمّن Apigee Edge أداة "التتبُّع" التي يمكنك استخدامها لفحص تسلسل تنفيذ خادم وكيل واجهة برمجة التطبيقات عند تصحيح الأخطاء واختبارها. تعرض الأداة بشكل مرئي كل خطوة من خطوات خادم وكيل واجهة برمجة التطبيقات التي يتم تنفيذها لطلب معيّن. كما هو الحال في أداة تصحيح الأخطاء، يمكنك في كل خطوة عرض قائمة بقيم المتغيرات التي تشكّل حالة خادم وكيل واجهة برمجة التطبيقات.
لمزيد من المعلومات حول تصحيح الأخطاء باستخدام Trace، يُرجى الاطّلاع على استخدام أداة Trace.
التعامل مع أخطاء خادم وكيل واجهة برمجة التطبيقات كأخطاء
من خلال ضبط معالج الأخطاء، يمكنك تخصيص الخطأ الذي يتم إرجاعه إلى عميل واجهة برمجة التطبيقات. تمنحك معالجات الأخطاء إمكانية التحكّم في رسائل الخطأ، سواء كان الخطأ ناتجًا عن الرمز البرمجي الخاص بك أو عن أحد المكوّنات المضمّنة (مثل السياسة).
لمزيد من المعلومات، اطّلِع على التعامل مع الأخطاء.