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