أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
يوضّح هذا الموضوع كيفية إنشاء أدوات وكيل لواجهات برمجة التطبيقات لخدمات الويب المستندة إلى SOAP. يمكنك إنشاء نوعَين من الوكلاء SOAP في Edge. ينشئ أحدهما واجهة RESTful لخدمة SOAP في الواجهة الخلفية، وينفّذ الآخر "تمرير" رسالة SOAP إلى الواجهة الخلفية. ويتم وصف كلتا الطريقتَين في هذا الموضوع.
يقدّم هذا الفيديو عرضًا تجريبيًا شاملاً لتحويل خدمة SOAP إلى خدمة REST باستخدام Apigee Edge باستخدام معالج وكيل واجهة برمجة التطبيقات. ومع ذلك، إذا كنت تريد التحكّم بشكل أكبر في عملية التحويل من SOAP إلى REST، يمكنك إنشاء وكيل باستخدام السياسات. لمزيد من المعلومات، اطّلِع على البرنامج التعليمي: إنشاء خادم وكيل يربط بين SOAP وREST API يدويًا في Apigee Edge.
إنشاء وكيل لواجهة برمجة تطبيقات RESTful إلى خدمة مستندة إلى SOAP
يوضّح هذا القسم كيفية إنشاء وكيل واجهة برمجة تطبيقات SOAP RESTful باستخدام الخيار REST إلى SOAP إلى REST في معالج "إنشاء وكيل".
نظرة عامة
يعالج خيار REST إلى SOAP إلى REST ملف WSDL لإنشاء وكيل واجهة برمجة تطبيقات مستند إلى بروتوكول REST. يحدِّد 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.
- أدخِل تفاصيل الخادم الوكيل التالية:
الحقل الوصف الاسم الاسم المعروض لواجهة برمجة التطبيقات. حدِّد أحرفًا أبجدية رقمية أو شرطة (-) أو شرطة سفلية (_). المسار الأساسي جزء من عنوان URL يظهر بعد عنوان http(s)://[host] لوكيل بروتوكول واجهة برمجة التطبيقات يستخدم Edge عنوان URL للمسار الأساسي لمطابقة رسائل الطلبات الواردة توجيهها إلى الوكيل المناسب لواجهة برمجة التطبيقات.
ملاحظة: المسار الأساسي لوكيل واجهة برمجة التطبيقات هو القيمة التلقائية المحدّدة لمحاولة تحويل حقل
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 إلى SOAP إلى
REST.
يظهر جدول يسرد العمليات التي "اكتشفها" Edge في ملف WSDL. يمكنك اختيار العمليات التي تريد دمجها في وكيل واجهة برمجة التطبيقات وضبطها. يظهر الجدول في الشكل التالي.
- اختَر نوع المنفذ من القائمة المنسدلة لتحديد مجموعة العمليات التي تريد استخدامها. في WSDL، تحدِّد عناصر نوع الموانئ العمليات التي يمكنك الاتصال بها في خدمة ويب.
- يمكنك اختياريًا تغيير مسار واجهة برمجة التطبيقات REST لإجراء معيّن. سيتم استخدام المسار كاسم المورد في عنوان URL للخادم الوكيل لواجهة برمجة التطبيقات.
- يمكنك اختياريًا تغيير الفعل (طريقة HTTP) المرتبط بالعملية.
- انقر على التالي.
- في صفحة المضيفون الظاهريون في المعالج، اختَر المضيفين الظاهريين الذين سيتم ربط خادم وكيل واجهة برمجة التطبيقات بهم عند نشره. لمزيد من المعلومات، اطّلِع على لمحة عن المضيفين الظاهريين.
- انقر على التالي.
- اختَر بيئات النشر وانقر على إنشاء ونشر
يتم إنشاء وكيل واجهة برمجة التطبيقات الجديد ويتم نشره في البيئة المحدّدة. - انقر على تعديل الخادم الوكيل لعرض صفحة تفاصيل خادم وكيل واجهة برمجة التطبيقات.
Classic Edge (سحابة خاصة)
لإنشاء وكيل لواجهة برمجة التطبيقات RESTful للخدمة المستندة إلى SOAP باستخدام واجهة مستخدم Edge الكلاسيكية:
- سجِّل الدخول إلى
http://ms-ip:9000، حيث يكون ms-ip هو عنوان IP أو اسم نظام أسماء النطاقات الخاص بعقدة "خادم الإدارة". - اختَر واجهات برمجة التطبيقات > أدوات الربط لواجهات برمجة التطبيقات في شريط التنقّل بأعلى الصفحة.
- انقر على + خادم وكيل لواجهة برمجة التطبيقات.
- في معالج "إنشاء خادم وكيل"، اختَر خدمة SOAP.
- انقر على التالي.
- في صفحة "التفاصيل"، عليك إجراء الاختيارات التالية: يجب النقر على التحقّق بعد
اختيار ملف WSDL.
في هذا الحقل اتّبِع الخطوات التالية: WSDL اختَر مصدر ملف WSDL.
- عنوان URL: أدخِل عنوان URL لملف WSDL الذي تريد استخدامه.
- ملف: اختَر ملف WSDL في نظام الملفات. في الحالات التي تتعلّق فيها ملفات إضافية بملف معيّن، يمكنك اختيار جميعها.
- مثال على عنوان URL: اختَر من قائمة ملفات WSDL لخدمات الويب المتاحة للجميع وهي مفيدة لتجربة ميزات وكيل SOAP/API في Edge.
اسم الخادم الوكيل هذا هو اسم الخادم الوكيل الذي تنشئه.
مسار الخادم الوكيل الأساسي جزء من عنوان URL يظهر بعد عنوان http(s)://[host] لوكيل بروتوكول واجهة برمجة التطبيقات يستخدم Edge عنوان URL للمسار الأساسي لمطابقة رسائل الطلبات الواردة توجيهها إلى الوكيل المناسب لواجهة برمجة التطبيقات.
ملاحظة: المسار الأساسي لوكيل واجهة برمجة التطبيقات هو القيمة التلقائية المحدّدة لمحاولة تحويل حقل
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 إلى SOAP إلى
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 عنوان URL للمسار الأساسي لمطابقة رسائل الطلبات الواردة توجيهها إلى الوكيل المناسب لواجهة برمجة التطبيقات.
ملاحظة: للاطّلاع على توصيات Apigee بشأن تحديد معلومات إصدار واجهة برمجة التطبيقات، يمكنك الاطّلاع على تحديد معلومات الإصدار في الكتاب الإلكتروني تصميم واجهة برمجة التطبيقات: الرابط المفقود.
بعد المسار الأساسي، تأتي أي عناوين 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، تحدِّد عناصر نوع الموانئ العمليات التي يمكنك الاتصال بها في خدمة ويب.
- انقر على التالي.
- في صفحة المضيفون الظاهريون في المعالج، اختَر المضيفين الظاهريين الذين سيتم ربط خادم وكيل واجهة برمجة التطبيقات بهم عند نشره. لمزيد من المعلومات، يمكنك الاطّلاع على لمحة عن المضيفين الظاهريين.
- اختَر بيئات النشر وانقر على إنشاء ونشر
يتم إنشاء وكيل واجهة برمجة التطبيقات الجديد ويتم نشره في البيئة المحدّدة. - انقر على تعديل الخادم الوكيل لعرض صفحة تفاصيل خادم وكيل واجهة برمجة التطبيقات.
Classic Edge (سحابة خاصة)
لإنشاء خادم وكيل للعبور إلى خدمة مستندة إلى SOAP باستخدام واجهة مستخدم Edge الكلاسيكية:
- سجِّل الدخول إلى
http://ms-ip:9000، حيث يكون ms-ip هو عنوان IP أو اسم نظام أسماء النطاقات الخاص بعقدة "خادم الإدارة". - اختَر واجهات برمجة التطبيقات > أدوات الربط لواجهات برمجة التطبيقات في شريط التنقّل بأعلى الصفحة.
- انقر على + خادم وكيل لواجهة برمجة التطبيقات.
- في معالج "إنشاء خادم وكيل"، اختَر خدمة SOAP.
- انقر على التالي.
- في صفحة "التفاصيل"، عليك إجراء الاختيارات التالية: يجب النقر على التحقّق بعد
اختيار ملف WSDL.
في هذا الحقل اتّبِع الخطوات التالية: WSDL اختَر مصدر ملف WSDL.
- عنوان URL: أدخِل عنوان URL لملف WSDL الذي تريد استخدامه.
- ملف: اختَر ملف WSDL في نظام الملفات. في الحالات التي تتوفّر فيها ملفات إضافية تابعة، يمكنك اختيارها كلها.
- مثال على عنوان URL: اختَر من قائمة ملفات WSDL لخدمات الويب المتاحة للجميع وهذه الأدوات مفيدة لتجربة ميزات وكيل SOAP/API في Edge.
اسم الخادم الوكيل هذا هو اسم الخادم الوكيل الذي تنشئه.
مسار الخادم الوكيل الأساسي "المسار الأساسي للوكيل" هو جزء من عنوان URL يحدِّد بشكل فريد واجهة برمجة التطبيقات التي يعرضها هذا الوكيل لواجهة برمجة التطبيقات. تستخدِم "خدمات واجهة برمجة التطبيقات" عنوان URL للمسار الأساسي لمطابقة رسائل الطلبات القادمة وتوجيهها إلى الوكيل المناسب لواجهة برمجة التطبيقات. (يتم إلحاق المسار الأساسي بنطاق واجهة برمجة التطبيقات، والذي يتم إنشاؤه تلقائيًا استنادًا إلى اسم مؤسستك والبيئة التي تم فيها نشر الوكيل لواجهة برمجة التطبيقات). من أفضل الممارسات تضمين رقم الإصدار في اسم المشروع، على سبيل المثال /v1/delayedstockquote. سيحدّد ذلك كيفية استدعاء واجهة برمجة التطبيقات من قِبل تطبيقات المستهلك.ملاحظة: المسار الأساسي للخادم الوكيل هو القيمة المحدّدة لاسم الخادم الوكيل التي تم تحويلها إلى أحرف صغيرة ما لم تعدِّل المحتوى صراحةً في حقل المسار الأساسي للخادم الوكيل.
الوصف وصف موجز للخادم الوكيل - انقر على التالي.
- في صفحة WSDL، اختَر نوع خادم وكيل واجهة برمجة التطبيقات Pass-Through SOAP.
ملاحظة: يظهر جدول يسرد كل عملية WSDL وملفه المرسَل المرتبط بتنسيق SOAP. هذه هي الحمولة التي يتم "تمريرها" إلى خدمة SOAP في الخلفية.
- اختَر مجموعة العمليات التي تريد استخدامها من عمود "نوع المنفذ". في WSDL، تحدِّد عناصر نوع المنفذ العمليات التي يمكنك الاتصال بها في خدمة ويب.
- انقر على باقي خطوات المعالج لإضافة الأمان واختيار المضيفين الظاهريين وبيئة النشر.
- في صفحة "الإنشاء"، انقر على الإنشاء والنشر. ينشئ Edge وينشر خادم الوكيل الجديد لواجهة برمجة التطبيقات استنادًا إلى WSDL.
لمحة عن الوكيل النهائي
عندما ينشئ Edge خادمًا وكيلاً للعبور، يكون الخادم الوكيل الناتج في الواقع عملية معقدة تتضمن سياسات لتحويل البيانات واستخراج المتغيّرات وضبطها ومعالجة الرسائل وغيرها. بعد إنشاء الخادم الوكيل للمرور، اطّلِع على العملية الناتجة في طريقة العرض "تطوير" لواجهة مستخدم إدارة واجهة برمجة التطبيقات. يمكنك الاطّلاع على السياسات التي تمت إضافتها.
على سبيل المثال، يعرض الشكل التالي جزء "المسار المُسبَق لنقطة النهاية المستهدَفة" من خادم وكيل للعبور. من جهة الطلب، يتم استخدام سياسة AssignMessage لضبط عنوان URL المستهدَف. من جانب الاستجابة، يتم تنفيذ السياسات لتحويل الاستجابة من XML إلى JSON، واستخراج جزء SOAP من الاستجابة إلى متغيّر، وضبط رسالة الاستجابة. تتم إضافة هذه السياسات (وغيرها) تلقائيًا عند إنشاء الخادم الوكيل.
ملف WSDL المستضاف على Edge: للاطّلاع على ملف WSDL المستضاف على Edge الذي تم إنشاؤه لهذا النوع من
الخوادم الوكيلة، انتقِل إلى http(s)://[proxy_domain]/[proxy_base_path]?wsdl.
تطوير وكيل SOAP إلى REST متقدّم
تناولت الأقسام السابقة إنشاء وكيل لواجهة برمجة التطبيقات SOAP إلى REST باستخدام معالج وكيل واجهة برمجة التطبيقات في Edge. ومع ذلك، إذا كنت تريد التحكّم بشكل أدق في عملية تحويل SOAP إلى REST، يمكنك تجاوز الإعدادات المبرمَجة التي يوفّرها المعالج وإنشاء وكيل عن طريق إضافة السياسات وضبطها يدويًا للحصول على السلوك الذي تريده. لمزيد من المعلومات، اطّلِع على البرنامج التعليمي: إنشاء خادم وكيل يربط بين SOAP وREST API يدويًا في Apigee Edge.