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