النقاط الرئيسية لتطوير الخادم الوكيل لواجهة برمجة التطبيقات

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

يسرد هذا الموضوع بعض الخصائص الأساسية للخوادم الوكيلة لواجهة برمجة التطبيقات، إلى جانب روابط إلى مزيد من المعلومات.

واجهات برمجة التطبيقات هي نقاط دخول لتطبيق واحد لاستخدام إمكانات تطبيق آخر. استخدام الخوادم الوكيلة لواجهة برمجة التطبيقات لإنشاء واجهات برمجة التطبيقات

في Apigee Edge، يتم تنفيذ الخوادم الوكيلة لواجهة برمجة التطبيقات من خلال ضبط منطق الخادم الوكيل لواجهة برمجة التطبيقات كسلسلة من الخطوات التي يتم تنفيذها استجابةً لطلب من رمز العميل. يمكنك عرض خادم وكيل لواجهة برمجة التطبيقات للعملاء من خلال تحديد نقاط النهاية التي تتضمن عنوان URL بمسارات موارد وفعل HTTP ومتطلبات النص وما إلى ذلك.

يُسمّى هذا الخادم الوكيل لواجهة برمجة التطبيقات، من منظور رمز العميل، إنّه واجهة برمجة التطبيقات.

للحصول على نظرة عامة على الخوادم الوكيلة لواجهة برمجة التطبيقات، يمكنك الاطّلاع على المقالة فهم واجهات برمجة التطبيقات والخوادم الوكيلة لواجهة برمجة التطبيقات.

يمكنك ترتيب تسلسل منطق الخادم الوكيل لواجهة برمجة التطبيقات باستخدام التدفقات.

في أي تطبيق، تتدفق البيانات من خلال التطبيق وفقًا لمنطق الشرط. في Apigee Edge، يتألف مسار المعالجة من تدفقات. التدفق هو سلسلة من المراحل (أو "الخطوات") التي يتألف منها مسار معالجة الخادم الوكيل لواجهة برمجة التطبيقات. التدفقات هي الطريقة التي يوفّر بها Apigee Edge مواضع لك لتطبيق المنطق والسلوك في أماكن محدّدة من العميل إلى مورد الخلفية، ثم العودة إلى العميل.

لمزيد من المعلومات عن التدفقات، راجِع التحكّم في كيفية تنفيذ الخادم الوكيل مع التدفقات.

يمكنك الوصول إلى بيانات الحالة من خلال متغيّرات التدفق التي أنشأتها الخوادم الوكيلة لواجهة برمجة التطبيقات.

يمكن للخادم الوكيل لواجهة برمجة التطبيقات الوصول إلى المتغيرات التي تمثّل حالة التنفيذ. يمكنك الوصول إلى هذه المتغيّرات من ملف XML الذي يضبط الخوادم الوكيلة لواجهة برمجة التطبيقات وسياساتها. يمكنك أيضًا الوصول إليها عند توسيع خادم وكيل لواجهة برمجة التطبيقات باستخدام لغة إجرائية، مثل Java أو JavaScript أو Python.

يتم الاحتفاظ بهذه المتغيرات من خلال Apigee Edge. ويتوفر بعضها بشكل تلقائي، وعادةً ما تكون شائعة لما تفعله الخوادم الوكيلة لواجهة برمجة التطبيقات (على سبيل المثال، لأنّها جزء من طلب HTTP). يمكنك أيضًا إنشاء المتغيرات الخاصة بك لاستيفاء شرط المنطق.

لمزيد من المعلومات عن المتغيّرات، راجِع إدارة حالة الخادم الوكيل باستخدام متغيّرات التدفق.

يمكنك تنفيذ الإجراءات الوكيلة لواجهة برمجة التطبيقات بشكل مشروط.

تمامًا كما هو الحال في معظم لغات البرمجة، يمكنك تنفيذ التعليمات البرمجية بشكل مشروط في الخوادم الوكيلة لواجهة برمجة التطبيقات. تستند الشروط غالبًا إلى حالة الخادم الوكيل لواجهة برمجة التطبيقات، التي يمكنك الوصول إليها من خلال متغيّرات التدفق. على سبيل المثال، يمكنك الحصول على شرط يتحقّق من وكيل المستخدم، ثم يعالج الطلب وفقًا لذلك.

لمزيد من المعلومات حول التنفيذ المشروط، راجِع متغيرات التدفق وشروطه.

أنت تنفِّذ معظم المنطق في خادم وكيل لواجهة برمجة التطبيقات باستخدام السياسات

يتم تجميع معظم المنطق الذي تضيفه إلى خادم وكيل لواجهة برمجة التطبيقات كسياسات. والسياسة هي أحد مكونات Apigee Edge التي تتضمن منطقًا وظيفيًا لمجال وظيفي، مثل إدارة عدد الزيارات والأمان. في حال ضبط سياسة باستخدام ملف XML، يتم ضبط الخصائص للمنطق الأساسي. ويمكنك ترتيب السياسات ضمن سلسلة من "الخطوات" ضمن التدفق حتى ينفِّذ الخادم الوكيل لواجهة برمجة التطبيقات المنطق بأفضل ترتيب يناسب أهداف الخادم الوكيل.

لمزيد من المعلومات عن السياسات، راجِع مقالة ما المقصود بالسياسة؟.

ويمكنك تضمين مجموعات من الوظائف القابلة لإعادة الاستخدام

عندما يشتمل الخادم الوكيل لواجهة برمجة التطبيقات على منطق سيتم استخدامه من عدة أماكن في الرمز الخاص بك، مثل الخوادم الوكيلة الأخرى لواجهة برمجة التطبيقات، يمكنك جمع هذا المنطق للطلبات من أماكن متعددة. على سبيل المثال، يمكنك تجميع منطق أمان في تدفق مشترك تستدعيه الخوادم الوكيلة الأخرى لواجهة برمجة التطبيقات، ما يقلل من التكرار على جميع الخوادم الوكيلة لواجهة برمجة التطبيقات.

لمزيد من المعلومات عن المسارات المشترَكة، اطّلِع على التدفقات المشترَكة القابلة لإعادة الاستخدام. لمزيد من المعلومات عن تسلسل الخادم الوكيل لواجهة برمجة التطبيقات، يُرجى الاطّلاع على سلسلة الخوادم الوكيلة لواجهة برمجة التطبيقات معًا.

يمكنك تصحيح الأخطاء في خادم وكيل باستخدام أداة التتبُّع.

يتضمّن Apigee Edge أداة التتبُّع التي يمكنك استخدامها لفحص مسار تنفيذ الخادم الوكيل لواجهة برمجة التطبيقات عند تصحيح الأخطاء والاختبار. وتعرض الأداة بشكل مرئي كل خطوة من خطوات الخادم الوكيل لواجهة برمجة التطبيقات يتم تنفيذها لأحد الطلبات. كما في برنامج تصحيح الأخطاء، يمكنك الاطّلاع في كل خطوة على قائمة قيم المتغيّرات التي تشكّل حالة الخادم الوكيل لواجهة برمجة التطبيقات.

لمزيد من المعلومات عن تصحيح الأخطاء باستخدام التتبُّع، يُرجى الاطّلاع على استخدام أداة التتبُّع.

تتعامل مع أخطاء الخادم الوكيل لواجهة برمجة التطبيقات باعتبارها أخطاءً

من خلال ضبط معالِج الأخطاء، يمكنك تخصيص الخطأ الذي يظهر لبرنامج واجهة برمجة التطبيقات. تمنحك معالِجات الأخطاء إمكانية التحكّم في رسائل الخطأ، سواء نشأ الخطأ من رمزك الخاص أو من مكوّن مضمّن (مثل سياسة).

لمزيد من المعلومات، يمكنك الاطّلاع على أخطاء المناولة.