تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

عرض خدمة SOAP كخادم وكيل لواجهة برمجة التطبيقات

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

يوضّح هذا الموضوع كيفية إنشاء خوادم وكيلة لواجهة برمجة التطبيقات لخدمات الويب المستندة إلى SOAP. يمكنك إنشاء نوعَين من خوادم وكيل SOAP في Edge. يُنشئ أحدهما واجهة RESTful لخدمة SOAP في الخلفية، بينما ينفّذ الآخر "تمريرًا" لرسالة SOAP إلى الخلفية. يتم وصف كلتا الطريقتين في هذا الموضوع.

يقدّم هذا الفيديو عرضًا توضيحيًا شاملاً حول كيفية تحويل خدمة SOAP إلى خدمة REST باستخدام Apigee Edge من خلال معالج خادم وكيل لواجهة برمجة التطبيقات. ومع ذلك، إذا كنت تريد المزيد من التحكّم في عملية التحويل من SOAP إلى REST، يمكنك إنشاء خادم وكيل باستخدام السياسات. لمزيد من المعلومات، يُرجى الاطّلاع على برنامج تعليمي: إنشاء خادم وكيل لواجهة برمجة تطبيقات SOAP إلى REST يدويًا في Apigee Edge.

إنشاء خادم وكيل لواجهة برمجة تطبيقات RESTful لخدمة تستند إلى SOAP

يوضّح هذا القسم كيفية إنشاء وكيل لواجهة برمجة تطبيقات SOAP متوافق مع REST باستخدام الخيار REST إلى SOAP إلى REST في معالج إنشاء الوكيل.

نظرة عامة

يعالج الخيار REST إلى SOAP إلى REST ملف WSDL لإنشاء وكيل لواجهة برمجة تطبيقات RESTful. يحدّد Edge من WSDL العمليات المتوافقة مع الخدمة ومعلمات الإدخال وما إلى ذلك. يتوقّع Edge طريقة HTTP التي يجب استخدامها لكل عملية. عادةً، يحوّل Edge عمليات إلى طلبات GET، التي تتميّز بإمكانية تخزينها مؤقتًا. يُعدّ Edge أيضًا نقطة النهاية المستهدَفة للخادم الخلفي، والتي يمكن أن تختلف حسب عملية SOAP.

بالنسبة إلى هذا النوع من الخوادم الوكيلة، تنشئ Edge تلقائيًا مواصفات OpenAPI، والتي يمكنك استخدامها لإنشاء مستندات واجهة برمجة التطبيقات.

الخطوات الأساسية

Edge

لإنشاء خادم وكيل لواجهة برمجة تطبيقات RESTful لخدمة مستندة إلى SOAP باستخدام واجهة مستخدم Edge، اتّبِع الخطوات التالية:

سجِّل الدخول إلى apigee.com/edge.
انقر على تطوير > خوادم وكيلة لواجهة برمجة التطبيقات في شريط التنقّل الأيمن.
انقر على +الخادم الوكيل.
انقر على خدمة SOAP.

في صفحة "تفاصيل الخادم الوكيل"، قدِّم ملف WSDL.

الحقل	الوصف
توفير ملف WSDL	اختَر مصدر WSDL. من عنوان الويب (URL): أدخِل عنوان URL الخاص بملف WSDL أو الصِقه. من الكمبيوتر: حمِّل ملف WSDL من الدليل المحلي. يمكنك تحميل ملفات متعددة إذا كانت هناك تبعيات.

الحقل

الوصف

توفير ملف WSDL

اختَر مصدر WSDL.

من عنوان الويب (URL): أدخِل عنوان URL الخاص بملف WSDL أو الصِقه.
من الكمبيوتر: حمِّل ملف WSDL من الدليل المحلي. يمكنك تحميل ملفات متعددة إذا كانت هناك تبعيات.

انقر على التحقّق من الصحة للتحقّق من صحة WSDL.

أدخِل تفاصيل الخادم الوكيل التالية:

الحقل الوصف

الاسم اسم واجهة برمجة التطبيقات المعروض يُرجى تحديد أحرف أبجدية رقمية أو شَرطة (-) أو شَرطة سفلية (_).

المسار الأساسي

الحقل	الوصف
الاسم	اسم واجهة برمجة التطبيقات المعروض يُرجى تحديد أحرف أبجدية رقمية أو شَرطة (-) أو شَرطة سفلية (_).
المسار الأساسي	جزء من معرّف الموارد المنتظم (URI) يظهر بعد العنوان http(s)://[host] لخادم وكيل واجهة برمجة التطبيقات يستخدم Edge عنوان URI للمسار الأساسي لمطابقة رسائل الطلبات الواردة وتوجيهها إلى خادم وكيل API المناسب. NOTE: يكون مسار قاعدة خادم وكيل واجهة برمجة التطبيقات تلقائيًا هو القيمة المحدّدة للحقل `Name`، مع تحويل جميع الأحرف إلى أحرف صغيرة. بعد المسار الأساسي، تأتي أي عناوين URL إضافية خاصة بالموارد. إليك بنية عنوان URL الكامل التي ستستخدمها البرامج لتنفيذ طلبات إلى خادم وكيل لواجهة برمجة التطبيقات: `https://[host]/base_path/conditional_flow_path` NOTE: يجب أن يكون المسار الأساسي فريدًا، ولا يمكنك نشر خادمَين وكيلَين لواجهة برمجة التطبيقات باستخدام المسار الأساسي نفسه. في حال تعديل خادم وكيل لواجهة برمجة التطبيقات تم نشره وضبط المسار الأساسي على القيمة نفسها التي تم ضبطها في المسار الأساسي لخادم وكيل آخر لواجهة برمجة التطبيقات، ستلغي Edge تلقائيًا نشر خادم وكيل لواجهة برمجة التطبيقات عند حفظه. قبل إعادة نشر خادم وكيل لواجهة برمجة التطبيقات، عليك تعديل المسار الأساسي ليكون فريدًا. استخدام أحرف البدل في المسارات الأساسية استخدِم حرف بدل واحدًا أو أكثر من `//` في المسارات الأساسية لخادم وكيل API لضمان توافق خوادم وكيل API مع التغييرات المستقبلية. على سبيل المثال، يتيح مسار أساسي بقيمة `/team//members` للعملاء طلب `https://[host]/team/blue/members` و`https://[host]/team/green/members` بدون الحاجة إلى إنشاء وكلاء جدد لواجهة برمجة التطبيقات لدعم فِرق جديدة. يُرجى العِلم بأنّ `/**/` غير متاح.
الوصف	(اختياري) وصف لواجهة برمجة التطبيقات

جزء من معرّف الموارد المنتظم (URI) يظهر بعد العنوان http(s)://[host] لخادم وكيل واجهة برمجة التطبيقات يستخدم Edge عنوان URI للمسار الأساسي لمطابقة رسائل الطلبات الواردة وتوجيهها إلى خادم وكيل API المناسب.

NOTE: يكون مسار قاعدة خادم وكيل واجهة برمجة التطبيقات تلقائيًا هو القيمة المحدّدة للحقل Name، مع تحويل جميع الأحرف إلى أحرف صغيرة.

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

https://[host]/base_path/conditional_flow_path

NOTE: يجب أن يكون المسار الأساسي فريدًا، ولا يمكنك نشر خادمَين وكيلَين لواجهة برمجة التطبيقات باستخدام المسار الأساسي نفسه. في حال تعديل خادم وكيل لواجهة برمجة التطبيقات تم نشره وضبط المسار الأساسي على القيمة نفسها التي تم ضبطها في المسار الأساسي لخادم وكيل آخر لواجهة برمجة التطبيقات، ستلغي Edge تلقائيًا نشر خادم وكيل لواجهة برمجة التطبيقات عند حفظه. قبل إعادة نشر خادم وكيل لواجهة برمجة التطبيقات، عليك تعديل المسار الأساسي ليكون فريدًا.

استخدام أحرف البدل في المسارات الأساسية

استخدِم حرف بدل واحدًا أو أكثر من /*/ في المسارات الأساسية لخادم وكيل API لضمان توافق خوادم وكيل API مع التغييرات المستقبلية. على سبيل المثال، يتيح مسار أساسي بقيمة /team/*/members للعملاء طلب https://[host]/team/blue/members وhttps://[host]/team/green/members بدون الحاجة إلى إنشاء وكلاء جدد لواجهة برمجة التطبيقات لدعم فِرق جديدة. يُرجى العِلم بأنّ /**/ غير متاح.

الوصف (اختياري) وصف لواجهة برمجة التطبيقات

انقر على التالي.
في صفحة السياسات الشائعة ضمن المعالج، اضبط ما يلي:
- متطلبات تفويض الأمان ضمن الأمان: التفويض اطّلِع على مقالة إضافة الأمان.
- إتاحة مشاركة الموارد المتعدّدة المصادر (CORS) ضمن الأمان: المتصفّح اطّلِع على إضافة إمكانية استخدام CORS.
- الحصص لحماية خدمة الخلفية من عدد الزيارات الكبير ضمن Quota اطّلِع على الحصص. (لا يتوفّر هذا الخيار إذا تم تحديد خيار "تفويض المرور").
في صفحة عمليات WSDL، اختَر نوع خادم وكيل واجهة برمجة التطبيقات REST إلى SOAP إلى REST.
يظهر جدول يعرض العمليات التي "اكتشفها" Edge في ملف WSDL. يمكنك اختيار العمليات التي تريد دمجها في خادم وكيل واجهة برمجة التطبيقات وضبطها. يظهر الجدول في الشكل التالي.
اختَر نوع المنفذ من القائمة المنسدلة لتحديد مجموعة العمليات التي تريد استخدامها. في WSDL، تحدّد عناصر نوع المنفذ العمليات التي يمكنك استدعاؤها في خدمة ويب.
يمكنك اختياريًا تغيير المسار لواجهة REST API لإجراء عملية. سيتم استخدام المسار كاسم المورد في عنوان URL لخادم وكيل واجهة برمجة التطبيقات.
يمكنك اختياريًا تغيير الفعل (طريقة HTTP) المرتبط بالعملية.
انقر على التالي.
في صفحة المضيفات الافتراضية ضمن المعالج، اختَر المضيفات الافتراضية التي سيتم ربط خادم وكيل واجهة برمجة التطبيقات بها عند نشرها. لمزيد من المعلومات، يمكنك الاطّلاع على لمحة عن المضيفات الافتراضية.
انقر على التالي.
اختَر بيئات النشر وانقر على إنشاء ونشر
سيتم إنشاء خادم وكيل جديد لواجهة برمجة التطبيقات ونشره في البيئة المحدّدة.
انقر على تعديل الخادم الوكيل لعرض صفحة التفاصيل الخاصة بخادم API الوكيل.

Classic Edge (Private Cloud)

لإنشاء خادم وكيل لواجهة برمجة تطبيقات RESTful لخدمة مستندة إلى SOAP باستخدام واجهة مستخدم Classic Edge، اتّبِع الخطوات التالية:

سجِّل الدخول إلى http://ms-ip:9000، حيث ms-ip هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة خادم الإدارة.
انقر على واجهات برمجة التطبيقات > خوادم وكيلة لواجهات برمجة التطبيقات في شريط التنقّل العلوي.
انقر على + خادم وكيل لواجهة برمجة التطبيقات.
في معالج "إنشاء خادم وكيل"، اختَر خدمة SOAP.
انقر على التالي.

في صفحة "التفاصيل"، حدِّد الخيارات التالية. يجب النقر على التحقّق بعد اختيار WSDL.

في هذا الحقل	اتّبِع الخطوات التالية
WSDL	اختَر مصدر WSDL. عنوان URL: أدخِل عنوان URL الخاص بملف WSDL الذي تريد استخدامه. ملف: اختَر ملف WSDL من نظام الملفات. في الحالات التي تتضمّن ملفات تابعة إضافية، يمكنك اختيارها كلها. مثال على عنوان URL: اختَر من قائمة WSDL لخدمات الويب المتاحة للجميع. تكون هذه الأمثلة مفيدة لتجربة ميزات خادم وكيل SOAP/API في Edge.
اسم الخادم الوكيل	هذا هو اسم الخادم الوكيل الذي تريد إنشاءه.
مسار قاعدة الخادم الوكيل	جزء من معرّف الموارد المنتظم (URI) يظهر بعد العنوان http(s)://[host] لخادم وكيل واجهة برمجة التطبيقات يستخدم Edge عنوان URI للمسار الأساسي لمطابقة رسائل الطلبات الواردة وتوجيهها إلى خادم وكيل API المناسب. ملاحظة: يكون مسار الأساس لوكيل واجهة برمجة التطبيقات تلقائيًا هو القيمة المحدّدة للحقل `Name`، مع تحويل جميع الأحرف إلى أحرف صغيرة. بعد المسار الأساسي، تأتي أي عناوين URL إضافية خاصة بالموارد. إليك بنية عنوان URL الكامل التي ستستخدمها البرامج لتنفيذ طلبات إلى خادم وكيل لواجهة برمجة التطبيقات: `https://[host]/base_path/conditional_flow_path` ملاحظة: يجب أن يكون المسار الأساسي فريدًا، ولا يمكنك نشر وسيطَين لواجهة برمجة التطبيقات باستخدام المسار الأساسي نفسه. في حال تعديل خادم وكيل لواجهة برمجة التطبيقات تم نشره وضبط المسار الأساسي على القيمة نفسها التي تم ضبطها في المسار الأساسي لخادم وكيل آخر لواجهة برمجة التطبيقات، ستلغي Edge تلقائيًا نشر خادم وكيل لواجهة برمجة التطبيقات عند حفظه. قبل إعادة نشر خادم وكيل لواجهة برمجة التطبيقات، عليك تعديل المسار الأساسي ليكون فريدًا. استخدام أحرف البدل في المسارات الأساسية استخدِم حرف بدل واحدًا أو أكثر من `//` في المسارات الأساسية لخادم وكيل API لضمان توافق خوادم وكيل API مع التغييرات المستقبلية. على سبيل المثال، يتيح مسار أساسي بقيمة `/team//members` للعملاء طلب `https://[host]/team/blue/members` و`https://[host]/team/green/members` بدون الحاجة إلى إنشاء وكلاء جدد لواجهة برمجة التطبيقات لدعم فِرق جديدة. يُرجى العِلم بأنّ `/**/` غير متاح.
الوصف	وصف موجز للخادم الوكيل

انقر على التالي.
في صفحة WSDL، اختَر نوع خادم وكيل واجهة برمجة التطبيقات REST إلى SOAP إلى REST.
يظهر جدول يعرض العمليات التي "اكتشفها" Edge في ملف WSDL. يمكنك اختيار العمليات التي تريد تضمينها في خادم وكيل واجهة برمجة التطبيقات وضبطها. يظهر الجدول في الشكل التالي.
اختَر من عمود "نوع المنفذ" مجموعة العمليات التي تريد استخدامها. في WSDL، تحدّد عناصر نوع المنفذ العمليات التي يمكنك استدعاؤها في خدمة ويب.
يمكنك اختياريًا تغيير طريقة HTTP المرتبطة بالعملية.

ملاحظة: يقدّم Edge "أفضل تخمين" في تحديد طريقة HTTP التي سيتم استخدامها لكل عملية. يُفضَّل بشكلٍ عام استخدام GET لأنّه يمكن تخزين طلبات GET مؤقتًا.
يمكنك اختياريًا تغيير مسار REST API لإحدى العمليات. سيتم استخدام المسار كاسم المورد في عنوان 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 صالحة تتضمّن مساحات أسماء صحيحة قبل إرسالها إلى الخدمة باستخدام طريقة POST. وبالمثل، عندما تعرض الخدمة استجابة 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.

في صفحة "تفاصيل الخادم الوكيل" (Proxy details)، قدِّم تفاصيل WSDL.

الحقل	الوصف
WSDL	اختَر مصدر WSDL. من عنوان الويب (URL): أدخِل عنوان URL الخاص بملف WSDL أو الصِقه. من الكمبيوتر: حمِّل ملف WSDL من الدليل المحلي. يمكنك تحميل ملفات متعددة إذا كانت هناك تبعيات.
الاسم	اسم خادم وكيل لواجهة برمجة التطبيقات
المسار الأساسي	جزء من معرّف الموارد المنتظم (URI) بعد العنوان http(s)://[host] الخاص بخادم وكيل واجهة برمجة التطبيقات يستخدم Edge عنوان URI للمسار الأساسي لمطابقة رسائل الطلبات الواردة وتوجيهها إلى خادم وكيل API المناسب. ملاحظة: للاطّلاع على اقتراحات Apigee بشأن تحديد إصدارات واجهات برمجة التطبيقات، راجِع تحديد الإصدارات في الكتاب الإلكتروني تصميم واجهات برمجة التطبيقات على الويب: الحلقة المفقودة. بعد المسار الأساسي، تظهر أي عناوين URL إضافية خاصة بالموارد. إليك بنية عنوان URL الكاملة التي ستستخدمها البرامج لإجراء طلبات إلى خادم وكيل لواجهة برمجة التطبيقات: `https://[host]/base_path/conditional_flow_path` ملاحظة: يجب أن يكون المسار الأساسي فريدًا. إذا عدّلت هذا الخادم الوكيل لاحقًا وضبطت مساره الأساسي ليكون هو نفسه مسار خادم وكيل آخر لواجهة برمجة التطبيقات، سيتم تلقائيًا إلغاء نشر خادم وكيل واجهة برمجة التطبيقات هذا عند حفظه. يجب تعديل المسار الأساسي قبل إعادة نشره. استخدام حرف بدل في المسارات الأساسية يمكنك استخدام حرف بدل واحد أو أكثر من أحرف البدل `//` في مسارات الأساس لوكيل API لتجهيز الوكلاء للمستقبل. على سبيل المثال، يسمح مسار أساسي بقيمة `/team//members` للعملاء بطلب البيانات من `https://[host]/team/blue/members` و`https://[host]/team/green/members` بدون الحاجة إلى إنشاء خوادم وكيلة جديدة لواجهة برمجة التطبيقات لدعم فِرق جديدة. يُرجى العِلم أنّ // غير متاح. ملاحظة**: يكون مسار الأساس لوكيل واجهة برمجة التطبيقات تلقائيًا هو القيمة المحدّدة لحقل "الاسم" بعد تحويلها إلى أحرف صغيرة، ما لم تعدّل المحتوى بشكل صريح في حقل "مسار الأساس".
الوصف	(اختياري) وصف لواجهة برمجة التطبيقات

انقر على التالي.
في صفحة السياسات الشائعة ضمن المعالج، اضبط ما يلي:
- متطلبات تفويض الأمان اطّلِع على مقالة إضافة الأمان.
- إتاحة مشاركة الموارد المتعدّدة المصادر (CORS) اطّلِع على إضافة إمكانية استخدام CORS.
- حصص لحماية خدمة الخلفية من الزيارات الكثيرة اطّلِع على الحصص. (لا يتوفّر هذا الخيار إذا تم تحديد خيار "تفويض المرور").
- فرض قيود على تحقيق الربح في المؤسسات التي فعّلت هذه الميزة اطّلِع على فرض حدود تحقيق الربح على خوادم وكيل واجهة برمجة التطبيقات.
في صفحة WSDL، اختَر نوع خادم وكيل لواجهة برمجة التطبيقات Pass-Through SOAP.
اختَر نوع المنفذ من القائمة المنسدلة لتحديد مجموعة العمليات التي تريد استخدامها. في WSDL، تحدّد عناصر نوع المنفذ العمليات التي يمكنك استدعاؤها في خدمة ويب.
انقر على التالي.
في صفحة المضيفات الافتراضية ضمن المعالج، اختَر المضيفات الافتراضية التي سيتم ربط خادم وكيل واجهة برمجة التطبيقات بها عند نشرها. لمزيد من المعلومات، يمكنك الاطّلاع على لمحة عن المضيفين الافتراضيين.
اختَر بيئات النشر وانقر على إنشاء ونشر
سيتم إنشاء خادم وكيل جديد لواجهة برمجة التطبيقات ونشره في البيئة المحدّدة.
انقر على تعديل الخادم الوكيل لعرض صفحة التفاصيل الخاصة بخادم API الوكيل.

Classic Edge (Private Cloud)

لإنشاء خادم وكيل تمريري لخدمة مستندة إلى SOAP باستخدام واجهة مستخدم Classic Edge، اتّبِع الخطوات التالية:

سجِّل الدخول إلى http://ms-ip:9000، حيث ms-ip هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة خادم الإدارة.
انقر على واجهات برمجة التطبيقات > خوادم وكيلة لواجهات برمجة التطبيقات في شريط التنقّل العلوي.
انقر على + خادم وكيل لواجهة برمجة التطبيقات.
في معالج "إنشاء خادم وكيل"، اختَر خدمة SOAP.
انقر على التالي.

في صفحة "التفاصيل"، حدِّد الخيارات التالية. يجب النقر على التحقّق بعد اختيار WSDL.

في هذا الحقل	اتّبِع الخطوات التالية
WSDL	اختَر مصدر WSDL. عنوان URL: أدخِل عنوان URL الخاص بملف WSDL الذي تريد استخدامه. ملف: اختَر ملف WSDL من نظام الملفات. في الحالات التي تتوفّر فيها ملفات إضافية تابعة، يمكنك اختيارها كلها. مثال على عنوان URL: اختَر من قائمة WSDL لخدمات الويب المتاحة للجميع. تكون هذه الأدوات مفيدة لتجربة ميزات خادم وكيل SOAP/API في Edge.
اسم الخادم الوكيل	هذا هو اسم الخادم الوكيل الذي تريد إنشاءه.
مسار قاعدة الخادم الوكيل	مسار الأساس للوكيل هو جزء من معرّف الموارد المنتظم (URI) يحدّد بشكل فريد واجهة برمجة التطبيقات التي يعرضها وكيل واجهة برمجة التطبيقات هذا. تستخدم "خدمات واجهة برمجة التطبيقات" معرّف الموارد المنتظم (URI) للمسار الأساسي لمطابقة رسائل الطلبات الواردة وتوجيهها إلى خادم وكيل واجهة برمجة التطبيقات المناسب. (يتم إلحاق المسار الأساسي بنطاق واجهة برمجة التطبيقات، الذي يتم إنشاؤه تلقائيًا استنادًا إلى اسم المؤسسة والبيئة التي يتم نشر خادم وكيل واجهة برمجة التطبيقات فيها). من أفضل الممارسات تضمين رقم الإصدار في اسم المشروع، مثل `/v1/delayedstockquote`. سيحدّد ذلك طريقة استدعاء التطبيقات الاستهلاكية لواجهة برمجة التطبيقات. ملاحظة: يكون مسار الخادم الوكيل الأساسي تلقائيًا هو القيمة المحدّدة لاسم الخادم الوكيل، مع تحويل جميع الأحرف إلى أحرف صغيرة، ما لم تعدّل المحتوى بشكل صريح في حقل مسار الخادم الوكيل الأساسي.
الوصف	وصف موجز للخادم الوكيل

انقر على التالي.
في صفحة WSDL، اختَر نوع خادم وكيل لواجهة برمجة التطبيقات Pass-Through SOAP.

ملاحظة: يظهر جدول يعرض كل عملية WSDL وحِمل SOAP المرتبط بها. هذه هي الحمولة التي يتم "تمريرها" إلى خدمة SOAP في الخلفية.
اختَر من عمود "نوع المنفذ" مجموعة العمليات التي تريد استخدامها. في WSDL، تحدّد عناصر نوع المنفذ العمليات التي يمكنك استدعاؤها في خدمة ويب.
انقر على بقية المعالج لإضافة الأمان واختيار المضيفات الافتراضية وبيئة النشر.
في صفحة "البناء"، انقر على البناء والنشر. تنشئ Edge وتنفّذ وكيل واجهة برمجة التطبيقات الجديد استنادًا إلى WSDL.

لمحة عن الوكيل النهائي

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

على سبيل المثال، يعرض الشكل التالي جزء Target Endpoint Preflow من خادم وكيل للتمرير. من جهة الطلب، يتم استخدام سياسة AssignMessage لضبط عنوان URL المستهدف. من جهة الاستجابة، يتم تنفيذ السياسات لتحويل الاستجابة من XML إلى JSON، واستخراج جزء نص SOAP من الاستجابة إلى متغير، وتعيين رسالة الاستجابة. تتم إضافة هذه السياسات (وغيرها) تلقائيًا عند إنشاء الخادم الوكيل.

في "طريقة عرض التطوير"، في لوحة "التسلسل"، تعرض الأسهم التسلسل من الطلب إلى الرد، وتعرض الرموز السياسات.

ملف WSDL المستضاف على الخادم الوكيل: للاطّلاع على ملف WSDL المستضاف على الخادم الوكيل الذي تم إنشاؤه لهذا النوع من الخادم الوكيل، انتقِل إلى http(s)://[proxy_domain]/[proxy_base_path]?wsdl.

تطوير وكيل متقدّم من SOAP إلى REST

تناولت الأقسام السابقة إنشاء خادم وكيل لواجهة برمجة تطبيقات SOAP إلى REST باستخدام معالج خادم وكيل لواجهة برمجة التطبيقات في Edge. ومع ذلك، إذا كنت تريد تحكّمًا أكثر دقةً في عملية التحويل من SOAP إلى REST، يمكنك تجاوز عملية التشغيل الآلي التي يوفّرها المعالج وإنشاء وكيل عن طريق إضافة السياسات وضبطها يدويًا للحصول على السلوك الذي تريده. لمزيد من المعلومات، راجِع البرنامج التعليمي: الإنشاء اليدوي لخادم وكيل لواجهة برمجة تطبيقات SOAP إلى REST في Apigee Edge.