إنشاء خادم وكيل SOAP | Apigee Edge

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

يوضح هذا البرنامج التعليمي كيفية إنشاء واجهة برمجة تطبيقات RESTful جديدة قبل واجهة برمجة تطبيقات SOAP خدمة ما. على الرغم من عدم توضيح ذلك بالتفصيل هنا، يمكنك أيضًا إنشاء خادم وكيل للمرور تقبل حمولة SOAP وتمررها إلى خدمة الخلفية.

المتطلبات

حساب على Apigee Edge إذا لم يكن لديك حساب حتى الآن، يمكنك الاشتراك من خلال التوجيهات. في إنشاء Apigee حساب Edge

إنشاء الخادم الوكيل

في هذه الحالة، ستملك Edge الخادم الوكيل الذي سيظهر أمام خدمة SOAP. هناك نوعان من خوادم SOAP API:

ينشئ نوع الخادم الوكيل REST-SOAP-REST واجهة برمجة تطبيقات RESTful جديدة مع ترجمة. لـ SOAP. يسميها العملاء كما هي الحال مع خدمات RESTful الأخرى، وتمرير الاستعلام المطلوبة بواسطة خدمة الخلفية. يترجم Edge هذا إلى حمولة SOAP المتوقعة من الخدمة.
يتيح نوع الخادم الوكيل تمرير سريع للعملاء تمرير حمولة SOAP ببساطة. هذه طريقة للاستفادة من مكالمات خدمة SOAP من ميزات إدارة Edge.

Edge

لإنشاء خادم وكيل لخدمة SOAP باستخدام واجهة مستخدم Edge:

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

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

الحقل	الوصف
مصدر WSDL	اختَر: عنوان URL انسخ عنوان URL التالي لـ WSLD والصقه في الحقل إدخال عنوان URL: https://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?wsdl انقر على التحقق من الصحة. يحصل Apigee Edge على ملف WSDL ويقرأه لاستكشاف قائمة العمليات. التي تدعمها خدمة SOAP.
الاسم	عدم اتّخاذ أي إجراء: `delayedstockquote` هذا هو اسم الخادم الوكيل لواجهة برمجة التطبيقات الذي تنشئه.
المسار الأساسي	عدم اتّخاذ أي إجراء: `/delayedstockquote`
الوصف	يمكنك إضافة وصف بشكل اختياري مثل: الخادم الوكيل لواجهة برمجة تطبيقات WSDL الخاصة بأسعار الأسهم.

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

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

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

الإصدار الكلاسيكي Edge (السحابة الإلكترونية الخاصة)

لإنشاء خادم وكيل لخدمة SOAP باستخدام واجهة مستخدم Edge الكلاسيكي:

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

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

الحقل الوصف

الحقل	الوصف
WSDL	اختَر: مثال على عنوان URL بعد ذلك، اختَر: ...delayedstockquote.asmx?WSDL انقر على التحقق من الصحة. يحصل Apigee Edge على ملف WSDL ويقرأه لاستكشاف قائمة العمليات. التي تدعمها خدمة SOAP.
اسم الخادم الوكيل	أدخِل: `delayedstockquote` هذا اسم للخادم الوكيل الذي تنشئه.
المسار الأساسي للخادم الوكيل والوصف	عدم اتّخاذ أي إجراء

WSDL

اختَر: مثال على عنوان URL

بعد ذلك، اختَر:
...delayedstockquote.asmx?WSDL

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

يحصل Apigee Edge على ملف WSDL ويقرأه لاستكشاف قائمة العمليات. التي تدعمها خدمة SOAP.

اسم الخادم الوكيل

أدخِل: delayedstockquote

هذا اسم للخادم الوكيل الذي تنشئه.

المسار الأساسي للخادم الوكيل والوصف عدم اتّخاذ أي إجراء

انقر على التالي.

في صفحة WSDL، حدِّد الخيارات التالية:

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

في هذا الحقل

إجراء ذلك

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

اختَر: REST إلى SOAP to REST

بعد تحديد نوع الخادم الوكيل، تعرض Edge قائمة العمليات التي يمكن فسيتم إنشاء مسارات واجهة برمجة تطبيقات REST، كما هو موضح هنا. تمنحك هذه القائمة فرصة يمكنك الاختيار من بين العمليات المتوفّرة في رخصة WSDL (في حال كان لديك قاعدة بيانات معيّنة المحددة التي تبحث عنها). لاحظ أن الجدول يعرض أيضًا الموارد التي يمكن أن يستخدم عميل REST طلب خدمة SOAP في الخلفية.

في الوقت الحالي، اترك مجموعة العمليات الأولى محدّدة.

نوع المنفذ: DelayedStockCurrencySoap

تحديد عمليات WSDL الثلاث جميعها. ولا تغيّر الإعدادات الأخرى.

انقر على التالي.
في صفحة "الأمان"، اختَر تمرير (بدون).
انقر على التالي.
اقبل الإعدادات الافتراضية للمضيف الافتراضي، وانقر على التالي.
في صفحة "Build" (إنشاء)، اقبل الإعدادات الافتراضية وانقر على Build and Publish (إنشاء ونشر) ابدأ في إنشاء الخادم الوكيل من Edge.
تنشئ Edge خادمًا وكيلاً لواجهة برمجة تطبيقات RESTful. ويحدد WSDL محتوى الخدمة والعمليات المعتمدة ومعلمات الإدخال وما إلى ذلك. تقترح Edge طريقة HTTP التي يجب استخدامها لكل عملية. وعادةً ما تقوم Edge بترجمة العمليات إلى طلبات GET، ميزة قابلية التخزين المؤقت. تقوم شبكة Edge أيضًا بإعداد نقطة النهاية المستهدفة في الخلفية، والتي يمكن أن تختلف لكل عملية SOAP.

ما لم تقم بتخصيص الخادم الوكيل الجديد (ولم تكن في هذا البرنامج التعليمي)، فليس هكذا. يمكنك الانتقال إلى اختبار الخادم الوكيل الجديد.

اختبار الخادم الوكيل

لتجربة الخادم الوكيل الذي أنشأته، افتح موجِّه الأوامر واستخدِم cURL. اكتب الأمر أدناه، حيث:

ORG هو اسم مؤسسة Edge التي أنشأت فيها الخادم الوكيل.
ENV هي البيئة التي يتم نشر الخادم الوكيل فيها.
يتجاوب المجال مع مثيل Edge الذي تستخدمه.

curl "https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

على سبيل المثال، إذا كانت مؤسستك docfood، تكون البيئة هي test، وكنت تستخدم سحابة إلكترونية Enterprise Cloud، فيمكنك تشغيل أمر مثل التالي:

curl "https://docfood-test.apigee.net/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

ملاحظة: قيمة معلَمة طلب البحث LicenseKey هي القيمة الوهمية/الاختبارية للخدمة.

إذا أدخلت GOOG لمعلمة طلب البحث StockSymbol، ينبغي أن تحصل على السعر الحالي لسهم Alphabet Inc. من الفئة C. على سبيل المثال:

{  
   "GetQuoteResponse":{  
      "GetQuoteResult":{  
         "StockSymbol":"GOOG",
         "LastTradeAmount":819.55,
         "LastTradeDateTime":"2017-02-13T14:33:00",
         "StockChange":5.88,
         "OpenAmount":816.0,
         "DayHigh":820.96,
         "DayLow":815.49,
         "StockVolume":785064,
         "PrevCls":813.67,
         "ChangePercent":"+0.72%",
         "FiftyTwoWeekRange":"663.28 - 841.95",
         "EarnPerShare":27.88,
         "PE":29.4,
         "CompanyName":"Alphabet Inc.",
         "QuoteError":false
      }
   }
}

الحصول على واجهة OpenAPI التي يتم إنشاؤها تلقائيًا المواصفات

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

للحصول على مواصفات OpenAPI، ما عليك سوى الانتقال إلى عنوان URL التالي:

curl https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/openapi.json

رصيد إضافي: كيف هل تكتشف المورد والأفعال ومعلمات الاستعلام التي يجب استخدامها؟

في طلب بيانات من واجهة برمجة التطبيقات التجريبي، استخدمت موردًا معيّنًا ومَعلمات طلب بحث محدّدة في طلب cURL إلى خدمة SOAP في الخلفية. ولكن كيف يمكنك اكتشاف ذلك بنفسك؟

المصدر والفعل

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

في علامة التبويب التطوير لخادم وكيل واجهة برمجة التطبيقات، في جزء المستكشف، ستظهَر لك قائمة التدفقات ضمن نقاط نهاية الخادم الوكيل. انقر فوق التدفق الذي تهتم به. على سبيل المثال: فإن سير عمل GetQuote هو اختيار جيد. ثم اعرض XML في جزء التعليمات البرمجية، الذي يعرض مسار المورد والفعل للتدفق في عنصر <Condition> العنصر: "/quote" وGET"

معامِلات طلب البحث

مع تحديد مسار GetQuote، انقر على السياسة الأولى في الرسم البياني عرض التدفق. يجب أن يكون سياسة "استخراج المتغيّرات" التي تسجّل مَعلمات طلب البحث من المتوقع اجتيازها: StockSymbol وLicenseKey. (إذا كنت تنشئ شبكة ابحث عن خدمة SOAP، فستخبرك بما يجب تمريره إلى LicenseKey).

يتم حفظ مَعلمات طلب البحث التي تم تسجيلها كمتغيّرات واستخدامها من خلال السياسة التالية من أجل إنشاء رسالة SOAP.