أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
تحدِّد إعدادات ProxyEndpoint طريقة استخدام تطبيقات العميل لواجهات برمجة التطبيقات من خلال Apigee Edge. تحدِّد سمة ProxyEndpoint عنوان URL لوكيل واجهة برمجة التطبيقات وسلوكه: السياسات التي سيتم تطبيقها والنقاط النهائية المستهدَفة التي سيتم توجيهها إليها، والشروط التي يجب استيفاؤها لتنفيذ هذه السياسات أو قواعد التوجيه.
باختصار، تحدِّد إعدادات ProxyEndpoint كل ما يجب فعله لتنفيذ واجهة برمجة التطبيقات.
نموذج سلبي
يمكن أن يحتوي الوكيل لواجهة برمجة التطبيقات على نقطة نهاية واحدة أو أكثر للوكيل. إنّ تحديد عناصر ProxyEndpoints متعددة هو آلية سهلة ومبسطة لتنفيذ واجهات برمجة تطبيقات متعددة في خادم وكيل واحد. يتيح لك ذلك إعادة استخدام السياسات و/أو منطق النشاط التجاري قبل استدعاء TargetEndpoint وبعده.
من ناحية أخرى، عند تحديد عناصر ProxyEndpoints متعددة في وكيل واجهة برمجة تطبيقات واحد، ينتهي بك الأمر بدمج العديد من واجهات برمجة التطبيقات غير ذات الصلة في عنصر واحد. ويجعل ذلك من الصعب قراءة أدوات الربط لواجهات برمجة التطبيقات وفهمها وتصحيح أخطاءها وصيانتها. يخالف ذلك الفلسفة الرئيسية لخدمات الوكيل لواجهات برمجة التطبيقات، وهي تسهيل إنشاء واجهات برمجة التطبيقات وصيانتها على المطوّرين.
التأثير
يمكن أن تؤدي نقاط نهاية الخادم الوكيل المتعددة في خادم وكيل واجهة برمجة التطبيقات إلى ما يلي:
- أن تجعل من الصعب على المطوّرين فهم الوكيل لواجهة برمجة التطبيقات وصيانتها
- تشويش الإحصاءات يتم تجميع بيانات الإحصاءات تلقائيًا على مستوى الخادم الوكيل. لا يتوفّر تحليل لصنّاف المقاييس حسب نقطة نهاية الخادم الوكيل ما لم تنشئ تقارير مخصّصة.
- تصعيب تحديد المشاكل وحلّها في الخوادم الوكيلة لواجهات برمجة التطبيقات
أفضل ممارسة
عند تنفيذ خادم وكيل جديد لواجهة برمجة التطبيقات أو إعادة تصميم خادم وكيل حالي لواجهة برمجة التطبيقات، استخدِم أفضل الممارسات التالية:
- نفِّذ وكيل واجهة برمجة تطبيقات واحدًا باستخدام نقطة نهاية وكيل واحدة.
- إذا كانت هناك واجهات برمجة تطبيقات متعددة تشترك في خادم مستهدَف شائع و/أو تتطلّب استخدام المنطق نفسه قبل أو بعد استدعاء الخادم المستهدَف، ننصحك باستخدام مسارات مشترَكة لتنفيذ هذا المنطق في الوكلاء المختلفين لواجهات برمجة التطبيقات.
- إذا كانت هناك واجهات برمجة تطبيقات متعددة تشترك في مسار أساسي مشترك للبدء، ولكنها تختلف في اللاحقة، استخدِم مسارات مشروطة في ProxyEndpoint واحد.
- إذا كان هناك وسيط واجهة برمجة تطبيقات يتضمّن عدة نقاط نهاية للوكيل ولم تكن هناك أي مشاكل فيه، ليس عليك اتّخاذ أي إجراء.
يؤدي استخدام نقطة نهاية واحدة من نوع ProxyEndpoint لكل خادم وكيل لواجهة برمجة التطبيقات إلى:
- الخوادم الوكيلة الأبسط والأسهل في الصيانة
- سيتم تسجيل معلومات أفضل في "إحصاءات Google"، مثل أداء الخادم الوكيل ووقت الاستجابة المستهدَف، بشكل منفصل بدلاً من تجميعها لجميع EndpointsProxy.
- تحديد المشاكل وحلّها بشكل أسرع