يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
يوضح هذا الموضوع كيفية إنشاء خوادم وكيلة لواجهة برمجة التطبيقات لخدمات الويب المستندة إلى SOAP. يمكنك إنشاء نوعين من خوادم SOAP الوكيلة في Edge. ينشئ أحدهما واجهة ReSTful لخدمة SOAP الخلفية وينفّذ الآخر "تمرير" لرسالة SOAP إلى الخلفية. يتم وصف كلا الأسلوبين في هذا الموضوع.
يقدّم هذا الفيديو عرضًا توضيحيًا شاملاً لتحويل خدمة SOAP إلى خدمة REST من خلال Apigee Edge باستخدام معالج الخادم الوكيل لواجهة برمجة التطبيقات. إذا كنت تريد المزيد من التحكّم في عملية تحويل SOAP إلى RST، يمكنك إنشاء خادم وكيل باستخدام السياسات. لمزيد من المعلومات، يُرجى الاطّلاع على البرنامج التعليمي: الإنشاء اليدوي لخادم وكيل SOAP-to-REST API في Apigee Edge.
إنشاء خادم وكيل RESTful API لخدمة مستندة إلى SOAP
يوضّح هذا القسم كيفية إنشاء خادم وكيل لواجهة برمجة تطبيقات RESTful SOAP باستخدام الخيار REST to SOAP to REST في معالج إنشاء خادم وكيل.
نظرة عامة
يعالج الخيار REST to SOAP to REST WSDL لإنشاء خادم وكيل لواجهة برمجة التطبيقات RESTful. يحدّد Edge العمليات المتوافقة للخدمة ومعلَمات الإدخال وما إلى ذلك من خلال WSDL. "يخمّن" Edge طريقة HTTP التي يجب استخدامها لكل عملية. يحوّل Edge عادةً العمليات إلى طلبات GET، وهي ميزة كونها قابلة للتخزين المؤقت. يقوم Edge أيضًا بإعداد نقطة النهاية المستهدفة للخلفية، والتي يمكن أن تختلف حسب عملية SOAP.
بالنسبة إلى هذا النوع من الخادم الوكيل، ينشئ Edge تلقائيًا مواصفات OpenAPI، التي يمكنك استخدامها لإنشاء وثائق واجهة برمجة التطبيقات.
الخطوات الأساسية
Edge
لإنشاء خادم وكيل RESTful API لخدمة مستندة إلى SOAP باستخدام واجهة مستخدم Edge:
- سجِّل الدخول إلى apigee.com/edge.
- حدّد التطوير > الخوادم الوكيلة لواجهة برمجة التطبيقات في شريط التنقل الأيمن.
- انقر على +خادم وكيل.
- انقر على خدمة SOAP.
- في صفحة تفاصيل الخادم الوكيل، قدِّم ملف WSDL.
الحقل الوصف تقديم ملف WSDL اختَر مصدر WSDL.
- من عنوان الويب (عنوان URL) - أدخِل عنوان URL لـ WSDL أو الصِقه.
- من الكمبيوتر - يمكنك تحميل ملف WSDL من الدليل المحلي. يمكنك تحميل ملفات متعددة إذا كانت هناك تبعيات.
- انقر على التحقّق من صحة WSDL.
- أدخِل تفاصيل الخادم الوكيل التالية:
الحقل الوصف الاسم الاسم المعروض لواجهة برمجة التطبيقات حدِّد أحرف أبجدية رقمية أو شَرطة (-) أو شرطة سفلية (_). مسار القاعدة جزء معرّف الموارد المنتظم (URI) الذي يظهر بعد عنوان http(s)://[host] للخادم الوكيل لواجهة برمجة التطبيقات يستخدم Edge معرّف الموارد المنتظم (URI) للمسار الأساسي لمطابقة رسائل الطلبات الواردة وتوجيهها إلى الخادم الوكيل الصحيح لواجهة برمجة التطبيقات.
ملاحظة: يتم تلقائيًا تحويل المسار الأساسي للخادم الوكيل لواجهة برمجة التطبيقات إلى القيمة المحدّدة للحقل
Nameوالتي تم تحويلها إلى أحرف صغيرة بالكامل.بعد المسار الأساسي، ستظهر أي عناوين URL إضافية للموارد. وفي ما يلي بنية عنوان URL الكاملة التي سيستخدمها العملاء لطلب الخادم الوكيل لواجهة برمجة التطبيقات:
https://[host]/base_path/conditional_flow_pathملاحظة: يجب أن يكون المسار الأساسي فريدًا من نوعه، ولا يمكنك نشر خادمَين وكيلَين لواجهة برمجة التطبيقات باستخدام المسار الأساسي نفسه. إذا عدَّلت خادمًا وكيلاً تم نشره لواجهة برمجة التطبيقات وضبطت المسار الأساسي على القيمة نفسها للمسار الأساسي لخادم وكيل آخر لواجهة برمجة التطبيقات، يلغي Edge تلقائيًا نشر الخادم الوكيل لواجهة برمجة التطبيقات عند حفظه. قبل إعادة نشر الخادم الوكيل لواجهة برمجة التطبيقات، يجب تعديل المسار الأساسي بحيث يكون فريدًا.
استخدام أحرف البدل في المسارات الأساسية
استخدِم حرف بدل
/*/واحدًا أو أكثر في المسارات الأساسية للخادم الوكيل لواجهة برمجة التطبيقات لحماية الخوادم الوكيلة لواجهة برمجة التطبيقات في المستقبل. على سبيل المثال، يتيح المسار الأساسي في/team/*/membersللعملاء الاتصال بـhttps://[host]/team/blue/membersوhttps://[host]/team/green/membersبدون الحاجة إلى إنشاء خوادم وكيلة جديدة لواجهة برمجة التطبيقات من أجل دعم الفِرق الجديدة. يُرجى العلم أنّ السمة/**/غير متوافقة.الوصف (اختياري) وصف واجهة برمجة التطبيقات. - انقر على التالي.
- في صفحة السياسات الشائعة بالمعالج، اضبط ما يلي:
- متطلبات تفويض الأمان ضمن الأمان: التفويض. راجِع إضافة أمان.
- إتاحة مشاركة الموارد المتعدّدة المصادر (CORS) ضمن الأمان: المتصفّح راجِع إضافة إتاحة سياسة مشاركة الموارد متعددة المصادر (CORS).
- الحصص لحماية خدمة الخلفية من عدد الزيارات المرتفع ضمن الحصة. راجِع الحصص. (لا تتوفّر هذه الميزة في حال اختيار تفويض المرور).
- في صفحة عمليات WSDL، اختَر نوع الخادم الوكيل لواجهة برمجة التطبيقات REST to SOAP to REST.
يظهر جدول يسرد العمليات التي "اكتشفها" Edge في ملف WSDL. يمكنك اختيار وضبط العمليات التي تريد دمجها في الخادم الوكيل لواجهة برمجة التطبيقات. يظهر الجدول في الشكل التالي.
- اختَر نوع المنفذ من القائمة المنسدلة لتحديد مجموعة العمليات التي تريد استخدامها. في WSDL، تحدد عناصر نوع المنفذ العمليات التي يمكنك طلبها على خدمة ويب.
- يمكنك اختياريًا تغيير مسار واجهة برمجة تطبيقات REST لأي عملية. سيتم استخدام المسار كاسم المورد في عنوان URL للخادم الوكيل لواجهة برمجة التطبيقات.
- يمكنك اختياريًا تغيير الفعل (طريقة HTTP) المرتبطة بالعملية.
- انقر على التالي.
- في صفحة المضيفين الافتراضيين من المعالج، اختَر المضيفات الافتراضية التي سيربطها الخادم الوكيل لواجهة برمجة التطبيقات عند نشرها. لمزيد من المعلومات، راجع معلومات عن المضيفين الافتراضيين.
- انقر على التالي.
- اختَر بيئات النشر وانقر على إنشاء ونشر
يتم إنشاء الخادم الوكيل الجديد لواجهة برمجة التطبيقات ونشره في البيئة المحدّدة. - انقر على تعديل الخادم الوكيل لعرض صفحة التفاصيل للخادم الوكيل لواجهة برمجة التطبيقات.
كلاسيكي Edge (السحابة الإلكترونية الخاصة)
لإنشاء خادم وكيل واجهة برمجة تطبيقات RESTful إلى خدمة مستندة إلى SOAP باستخدام واجهة مستخدم الإصدار الكلاسيكي من Edge:
- سجِّل الدخول إلى
http://ms-ip:9000، حيث يشير ms-ip إلى عنوان IP أو اسم نظام أسماء النطاقات لعقدة خادم الإدارة. - حدد واجهات برمجة التطبيقات > الخوادم الوكيلة لواجهة برمجة التطبيقات في شريط التنقل العلوي.
- انقر على + الخادم الوكيل لواجهة برمجة التطبيقات.
- في معالج إنشاء خادم وكيل، حدد خدمة SOAP.
- انقر على التالي.
- في صفحة التفاصيل، حدد هذه الاختيارات. يجب النقر على التحقق بعد اختيار WSDL.
في هذا الحقل افعل هذا WSDL اختَر مصدر WSDL.
- عنوان URL: أدخِل عنوان URL الخاص بـ WSDL الذي تريد استخدامه.
- ملف - اختَر ملف WSDL على نظام الملفات. وفي الحالات التي تتوفر فيها ملفات إضافية تابعة، يمكنك اختيار جميع الملفات التابعة.
- مثال على عنوان URL: اختَر من قائمة WSDL لخدمات الويب المتاحة للجميع. وهي مفيدة لتجربة ميزات SOAP/واجهة برمجة التطبيقات الوكيلة في Edge.
اسم الخادم الوكيل هذا اسم للخادم الوكيل الذي تُنشئه.
المسار الأساسي للخادم الوكيل جزء معرّف الموارد المنتظم (URI) الذي يظهر بعد عنوان http(s)://[host] للخادم الوكيل لواجهة برمجة التطبيقات يستخدم Edge معرّف الموارد المنتظم (URI) للمسار الأساسي لمطابقة رسائل الطلبات الواردة وتوجيهها إلى الخادم الوكيل الصحيح لواجهة برمجة التطبيقات.
ملاحظة: يتم ضبط المسار الأساسي للخادم الوكيل لواجهة برمجة التطبيقات تلقائيًا على القيمة المحدّدة للحقل
Nameمع تحويل الأحرف إلى أحرف صغيرة.بعد المسار الأساسي، ستظهر أي عناوين URL إضافية للموارد. وفي ما يلي بنية عنوان URL الكاملة التي سيستخدمها العملاء لطلب الخادم الوكيل لواجهة برمجة التطبيقات:
https://[host]/base_path/conditional_flow_pathملاحظة: يجب أن يكون المسار الأساسي فريدًا، فلا يمكنك نشر خادمين وكيلين لواجهة برمجة تطبيقات يتضمّنان المسار الأساسي نفسه. إذا عدَّلت خادمًا وكيلاً تم نشره لواجهة برمجة التطبيقات وضبطت المسار الأساسي على القيمة نفسها للمسار الأساسي لخادم وكيل آخر لواجهة برمجة التطبيقات، يلغي Edge تلقائيًا نشر الخادم الوكيل لواجهة برمجة التطبيقات عند حفظه. قبل إعادة نشر الخادم الوكيل لواجهة برمجة التطبيقات، يجب تعديل المسار الأساسي بحيث يكون فريدًا.
استخدام أحرف البدل في المسارات الأساسية
استخدِم حرف بدل
/*/واحدًا أو أكثر في المسارات الأساسية للخادم الوكيل لواجهة برمجة التطبيقات لحماية الخوادم الوكيلة لواجهة برمجة التطبيقات في المستقبل. على سبيل المثال، يتيح المسار الأساسي في/team/*/membersللعملاء الاتصال بـhttps://[host]/team/blue/membersوhttps://[host]/team/green/membersبدون الحاجة إلى إنشاء خوادم وكيلة جديدة لواجهة برمجة التطبيقات من أجل دعم الفِرق الجديدة. يُرجى العلم أنّ السمة/**/غير متوافقة.الوصف وصف موجز للخادم الوكيل. - انقر على التالي.
- في صفحة WSDL، اختَر نوع الخادم الوكيل لواجهة برمجة التطبيقات REST to SOAP to REST.
يظهر جدول يسرد العمليات التي "اكتشفها" Edge في ملف WSDL. يمكنك اختيار وضبط العمليات التي تريد دمجها في الخادم الوكيل لواجهة برمجة التطبيقات. يظهر الجدول في الشكل التالي.
- من عمود "نوع المنفذ"، حدد مجموعة العمليات التي ترغب في استخدامها. في WSDL، تحدد عناصر نوع المنفذ العمليات التي يمكنك طلبها على خدمة ويب.
- يمكنك اختياريًا تغيير طريقة HTTP المرتبطة بالعملية.
ملاحظة: يقدّم متصفّح Edge "أفضل تخمين" عند تحديد طريقة HTTP لاستخدامها مع كل عملية. ويُفضَّل GET بشكل عام لأن طلبات GET يمكن تخزينها مؤقتًا.
- يمكنك بشكل اختياري تغيير مسار واجهة برمجة تطبيقات REST للعملية. سيتم استخدام المسار كاسم المورد في عنوان URL للخادم الوكيل لواجهة برمجة التطبيقات.
- انقر على بقية المعالج لإضافة الأمان وتحديد المضيفين الافتراضيين وبيئة النشر.
- في صفحة الإصدار، انقر على إنشاء ونشر. ينشئ Edge وينشر الخادم الوكيل الجديد لواجهة برمجة التطبيقات استنادًا إلى WSDL.
- انتقِل إلى صفحة الملخّص الخاصة بالخادم الوكيل الجديد لواجهة برمجة التطبيقات. يُرجى العِلم أنّه تم إنشاء مجموعة من الموارد استنادًا إلى العمليات التي تم اكتشافها في ملف WSDL.
في صفحة "نظرة عامة" للخادم الوكيل، توفر قائمة الموارد وصفًا تفصيليًا لواجهة برمجة التطبيقات الجديدة وعملياتها ومعلَماتها. ويمكنك اعتبار هذا التمثيل بمثابة المستندات المرجعية لواجهة برمجة التطبيقات. ينشئ Edge هذا العرض لنموذج واجهة برمجة التطبيقات تلقائيًا نيابة عنك. ما عليك سوى توسيع المورد للاطّلاع على معلومات الوصف ومساره.
لمحة عن الخادم الوكيل النهائي
عندما ينشئ Edge الخادم الوكيل لواجهة برمجة التطبيقات استنادًا إلى WSDL، يكون الخادم الوكيل الناتج في الواقع تدفقًا معقدًا يتضمن سياسات لتحويل البيانات واستخراج البيانات وإعدادها ومعالجة الرسائل وغير ذلك. بعد إنشاء خادم وكيل استنادًا إلى WSDL، ألق نظرة على التدفق الناتج في طريقة عرض "التطوير" في واجهة مستخدم إدارة واجهة برمجة التطبيقات. ويمكنك من هذه الصفحة الاطّلاع على السياسات التي تمت إضافتها تحديدًا.
على سبيل المثال، في جانب الطلب، يتم استخدام سياسة AssignMessage لضبط عنوان URL المستهدف. في جانب الاستجابة، يتم تنفيذ السياسات لتحويل الاستجابة من XML إلى JSON، واستخراج جزء نص SOAP من الاستجابة إلى متغيّر، وإعداد رسالة الاستجابة. تتم إضافة هذه السياسات (وسياسات أخرى) تلقائيًا عند إنشاء الخادم الوكيل.
مواصفات OpenAPI: لعرض مواصفات OpenAPI التي تم إنشاؤها تلقائيًا لهذا الخادم الوكيل،
يُرجى الانتقال إلى http(s)://[proxy_domain]/[proxy_base_path]/openapi.json. ومع ذلك، لا تكون الإحالة الناجحة دقيقة دائمًا، لأنّه لا يمكن تمثيل جميع قواعد مخطّط XML في مواصفات OpenAPI.
إنشاء وكيل مرور إلى خدمة مستندة إلى SOAP
يوضِّح هذا القسم كيفية إنشاء خادم وكيل للتمرير باستخدام الخيار خادم وكيل للبيانات في مربّع الحوار "إنشاء خادم وكيل جديد".
نظرة عامة
يتيح لك خيار "الخادم الوكيل للتنقل" إنشاء خادم وكيل يمرّر رسالة SOAP في طلب إلى خدمة الخلفية "بدون إصلاح"، ما يسهِّل بشكل كبير إنشاء خادم وكيل لخدمة ويب مستندة إلى SOAP. وخلف الكواليس، يعالج Edge أي عمليات تحويل وأنشطة تدفق أخرى نيابة عنك تلقائيًا. على سبيل المثال، إذا كان الطلب بتنسيق JSON، يتخذ Edge الخطوات لتحويله إلى رسالة XML SOAP صالحة مع مساحات اسم صحيحة قبل نشره في الخدمة. وبالمثل، عندما تعرض الخدمة استجابة SOAP مستندة إلى XML، يحوّلها Edge إلى تنسيق JSON قبل إرجاعها إلى البرنامج. بالإضافة إلى ذلك، يُعِد Edge نقطة النهاية المستهدفة للخلفية، والتي يمكن أن تختلف حسب عملية SOAP.
بالنسبة إلى هذا النوع من الخادم الوكيل، يستضيف Edge WSDL وينشئ تدفقًا في الخادم الوكيل للسماح لك بالوصول إليه. سيصبح عنوان WSDL هذا الذي يستضيفه Edge،
http(s)://[proxy_domain]/[proxy_base_path]?wsdl، عنوان URL الجديد لنقطة نهاية الخدمة
للعملاء الذين يستدعون خدمة SOAP من خلال الخادم الوكيل.
الخطوات الأساسية
Edge
لإنشاء خادم وكيل للتمرير إلى خدمة مستندة إلى SOAP باستخدام واجهة مستخدم Edge:
- سجِّل الدخول إلى apigee.com/edge.
- حدّد التطوير > الخوادم الوكيلة لواجهة برمجة التطبيقات في شريط التنقل الأيمن.
- انقر على +خادم وكيل.
- انقر على خدمة SOAP.
- في صفحة تفاصيل الخادم الوكيل، قدِّم تفاصيل WSDL.
الحقل الوصف WSDL اختَر مصدر WSDL.
- من عنوان الويب (عنوان URL) - أدخِل عنوان URL لـ WSDL أو الصِقه.
- من الكمبيوتر - يمكنك تحميل ملف WSDL من الدليل المحلي. يمكنك تحميل ملفات متعددة إذا كانت هناك تبعيات.
الاسم اسم الخادم الوكيل لواجهة برمجة التطبيقات.
مسار القاعدة جزء من معرّف الموارد المنتظم (URI) بعد عنوان http(s)://[host] للخادم الوكيل لواجهة برمجة التطبيقات يستخدم Edge معرّف الموارد المنتظم (URI) للمسار الأساسي لمطابقة رسائل الطلبات الواردة وتوجيهها إلى الخادم الوكيل الصحيح لواجهة برمجة التطبيقات.
ملاحظة: للحصول على اقتراحات Apigee بشأن إصدارات واجهة برمجة التطبيقات، يُرجى الاطّلاع على تحديد الإصدارات في الكتاب الإلكتروني Web API Design: The Missing Link.
بعد المسار الأساسي، تظهر أي عناوين URL إضافية للموارد. في ما يلي بنية عنوان URL الكاملة التي سيستخدمها العملاء لطلب الخادم الوكيل لواجهة برمجة التطبيقات:
https://[host]/base_path/conditional_flow_pathملاحظة: يجب أن يكون المسار الأساسي فريدًا. إذا عدّلت هذا الخادم الوكيل لاحقًا وضبطت مساره الأساسي ليكون مطابقًا لخادم وكيل آخر لواجهة برمجة التطبيقات، سيتم إلغاء نشره تلقائيًا عند حفظه. يجب تعديل المسار الأساسي قبل إعادة نشره.
استخدام حرف بدل في المسارات الأساسية
يمكنك استخدام حرف بدل واحد أو أكثر من
/*/في المسارات الأساسية للخادم الوكيل لواجهة برمجة التطبيقات لحماية الخوادم الوكيلة في المستقبل. على سبيل المثال، يتيح المسار الأساسي في/team/*/membersللعملاء الاتصال بـhttps://[host]/team/blue/membersوhttps://[host]/team/green/membersبدون الحاجة إلى إنشاء خوادم وكيلة جديدة لواجهة برمجة التطبيقات من أجل دعم الفِرق الجديدة. ولا يمكن استخدام /**/.ملاحظة: يتم ضبط المسار الأساسي للخادم الوكيل لواجهة برمجة التطبيقات تلقائيًا على القيمة المحدّدة في حقل "الاسم"، ويتم تحويله إلى أحرف صغيرة إلا إذا عدّلت المحتوى صراحةً في حقل "المسار الأساسي".
الوصف (اختياري) وصف واجهة برمجة التطبيقات. - انقر على التالي.
- في صفحة السياسات الشائعة بالمعالج، اضبط ما يلي:
- متطلبات تفويض الأمان. راجِع إضافة أمان.
- إتاحة مشاركة الموارد من مصادر متعددة (CORS). راجِع إضافة إتاحة سياسة مشاركة الموارد متعددة المصادر (CORS).
- الحصص لحماية خدمة الخلفية من عدد الزيارات المرتفع. راجِع الحصص. (لا تتوفّر هذه الميزة في حال اختيار تفويض المرور).
- فرض حدود على تحقيق الربح في المؤسسات التي تفعِّل ميزة تحقيق الربح يُرجى الاطّلاع على فرض حدود لتحقيق الربح على الخوادم الوكيلة لواجهة برمجة التطبيقات.
- في صفحة WSDL، اختَر نوع الخادم الوكيل لواجهة برمجة التطبيقات Pass-Through SOAP.
- اختَر نوع المنفذ من القائمة المنسدلة لتحديد مجموعة العمليات التي تريد استخدامها. في WSDL، تحدد عناصر نوع المنفذ العمليات التي يمكنك طلبها على خدمة ويب.
- انقر على التالي.
- في صفحة المضيفين الافتراضيين من المعالج، اختَر المضيفات الافتراضية التي سيربطها الخادم الوكيل لواجهة برمجة التطبيقات عند نشرها. لمزيد من المعلومات، راجِع لمحة عن المضيفين الافتراضيين.
- اختَر بيئات النشر وانقر على إنشاء ونشر
يتم إنشاء الخادم الوكيل الجديد لواجهة برمجة التطبيقات ونشره في البيئة المحدّدة. - انقر على تعديل الخادم الوكيل لعرض صفحة التفاصيل للخادم الوكيل لواجهة برمجة التطبيقات.
كلاسيكي Edge (السحابة الإلكترونية الخاصة)
لإنشاء خادم وكيل للتمرير إلى خدمة مستندة إلى SOAP باستخدام واجهة مستخدم الإصدار الكلاسيكي من Edge:
- سجِّل الدخول إلى
http://ms-ip:9000، حيث يشير ms-ip إلى عنوان IP أو اسم نظام أسماء النطاقات لعقدة خادم الإدارة. - حدد واجهات برمجة التطبيقات > الخوادم الوكيلة لواجهة برمجة التطبيقات في شريط التنقل العلوي.
- انقر على + الخادم الوكيل لواجهة برمجة التطبيقات.
- في معالج إنشاء خادم وكيل، حدد خدمة SOAP.
- انقر على التالي.
- في صفحة التفاصيل، حدد هذه الاختيارات. يجب النقر على التحقق بعد اختيار WSDL.
في هذا الحقل افعل هذا WSDL اختَر مصدر WSDL.
- عنوان URL - أدخِل عنوان URL لـ WSDL الذي تريد استخدامه.
- ملف - اختَر ملف WSDL على نظام الملفات. وفي الحالات التي يتوفر فيها مزيد من الملفات التابعة، يمكنك اختيارها كلها.
- مثال على عنوان URL: اختَر من قائمة WSDL لخدمات الويب المتاحة للجميع. هذه الملفات مفيدة لتجربة ميزات خادم SOAP/واجهة برمجة التطبيقات الوكيلة في Edge.
اسم الخادم الوكيل هذا اسم للخادم الوكيل الذي تُنشئه.
المسار الأساسي للخادم الوكيل "مسار الخادم الوكيل" الأساسي هو جزء من عنوان URI يحدّد بشكل فريد واجهة برمجة التطبيقات التي يعرضها الخادم الوكيل لواجهة برمجة التطبيقات هذا. تستخدم خدمات واجهات برمجة التطبيقات معرّف الموارد المنتظم (URI) للمسار الأساسي لمطابقة رسائل الطلبات الواردة وتوجيهها إلى الخادم الوكيل المناسب لواجهة برمجة التطبيقات. (يتم إلحاق "المسار الأساسي" بنطاق واجهة برمجة التطبيقات، الذي يتم إنشاؤه تلقائيًا استنادًا إلى اسم مؤسستك والبيئة التي يتم فيها نشر الخادم الوكيل لواجهة برمجة التطبيقات.) ومن أفضل الممارسات تضمين رقم إصدار في اسم المشروع، على سبيل المثال /v1/delayedstockquote. سيحدد ذلك كيفية استدعاء تطبيقات المستهلكين لواجهة برمجة التطبيقات.ملاحظة: يتم ضبط "المسار الأساسي للخادم الوكيل" تلقائيًا على القيمة المحدّدة لاسم الخادم الوكيل مع تحويلها إلى أحرف صغيرة إلا إذا عدّلت المحتوى بشكلٍ صريح في حقل "مسار الخادم الوكيل" الأساسي.
الوصف وصف موجز للخادم الوكيل. - انقر على التالي.
- في صفحة WSDL، اختَر نوع الخادم الوكيل لواجهة برمجة التطبيقات Pass-Through SOAP.
ملاحظة: يظهر جدول يسرد كل عملية WSDL وحمولة SOAP المقابلة لها. وهي الحمولة التي "يتم تمريرها" إلى خدمة SOAP الخلفية.
- من عمود "نوع المنفذ"، حدد مجموعة العمليات التي ترغب في استخدامها. في WSDL، تحدد عناصر نوع المنفذ العمليات التي يمكنك طلبها على خدمة ويب.
- انقر على بقية المعالج لإضافة الأمان وتحديد المضيفين الافتراضيين وبيئة النشر.
- في صفحة الإصدار، انقر على إنشاء ونشر. ينشئ Edge وينشر الخادم الوكيل الجديد لواجهة برمجة التطبيقات استنادًا إلى WSDL.
لمحة عن الخادم الوكيل النهائي
عندما ينشئ Edge خادمًا وكيلاً لنقل البيانات، يكون الخادم الوكيل الناتج في الواقع تدفقًا معقدًا يتضمن سياسات لتحويل البيانات واستخراج البيانات وضبط المتغيّرات ومعالجتها وغيرها من الإجراءات. بعد إنشاء الخادم الوكيل لتمرير المحتوى، ألق نظرة على التدفق الناتج في طريقة العرض "التطوير" في واجهة المستخدم الخاصة بإدارة واجهة برمجة التطبيقات. ويمكنك من هذه الصفحة الاطّلاع على السياسات التي تمت إضافتها تحديدًا.
على سبيل المثال، يوضّح الشكل التالي جزء "التدفق المسبق لنقطة النهاية المستهدفة" من الخادم الوكيل للتمرير. في جانب الطلب، يتم استخدام سياسة AssignMessage لإعداد عنوان URL المستهدَف. في جانب الاستجابة، يتم تنفيذ السياسات لتحويل الاستجابة من XML إلى JSON، واستخراج جزء نص SOAP من الاستجابة إلى متغيّر، وإعداد رسالة الاستجابة. تتم إضافة هذه السياسات (وسياسات أخرى) تلقائيًا عند إنشاء الخادم الوكيل.
WSDL المستضافة على الحافة: للاطّلاع على WSDL المستضافة على Edge الذي تم إنشاؤه لهذا النوع من الخادم الوكيل، انتقِل إلى http(s)://[proxy_domain]/[proxy_base_path]?wsdl.
تطوير الخادم الوكيل لبروتوكول SOAP إلى REST
تناولت الأقسام السابقة إنشاء خادم وكيل SOAP-to-REST API باستخدام معالج الخادم الوكيل لواجهة برمجة التطبيقات في Edge. مع ذلك، إذا كنت تريد مزيدًا من التحكّم بشكل أكثر دقة في عملية تحويل SOAP إلى REST، يمكنك تجاوز التشغيل الآلي الذي يوفّره المعالج وإنشاء خادم وكيل عن طريق إضافة السياسات وإعدادها يدويًا للوصول إلى السلوك الذي تريده. لمزيد من المعلومات، يُرجى الاطّلاع على البرنامج التعليمي: الإنشاء اليدوي لخادم وكيل SOAP-to-REST API في Apigee Edge.