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