مشاركة عبر

استيراد واجهة برمجة تطبيقات SOAP إلى APIM وتحويلها إلى REST

ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات

يوضح هذا المقال كيفية استيراد SOAP API كمواصفات WSDL ثم تحويله إلى REST API. كما يوضح كيفية اختبار واجهة برمجة التطبيقات في Azure API Management.

في هذه المقالة، ستتعرف على كيفية:

  • استيراد واجهة برمجة تطبيقات SOAP وتحويلها إلى REST
  • حدد التطبيق في مدخل Microsoft Azure

إشعار

يخضع استيراد WSDL إلى APIM لقيود معينة. ملفات WSDL ذات التوجيهات wsdl:import وxsd:import وxsd:include غير مدعومة. للحصول على أداة مفتوحة المصدر لحل هذه التبعيات ودمجها في ملف WSDL، راجع GitHub repo.

المتطلبات الأساسية

الانتقال إلى مثيل إدارة واجهة برمجة التطبيقات لديك

  1. في مدخل Microsoft Azure، ابحث عن خدمات APIM وحددها:

    لقطة شاشة تعرض خدمات APIM في نتائج البحث.

  2. في صفحة خدمات إدارة واجهة برمجة التطبيقات ، حدد مثيل إدارة واجهة برمجة التطبيقات:

    لقطة شاشة تعرض مثيل APIM في صفحة خدمات APIM.

استيراد ونشر واجهة برمجة تطبيقات خلفية

  1. في الجزء الأيمن، في قسم واجهات برمجة التطبيقات ، حدد واجهات برمجة التطبيقات.

  2. في صفحة واجهات برمجة التطبيقات، حدد + إضافة واجهة برمجة تطبيقات.

  3. ضمن إنشاء من التعريف، حدد WSDL:

    لقطة شاشة تعرض تجانب WSDL في مدخل Microsoft Azure.

  4. في WSDL specification، أدخل عنوان URL إلى SOAP API، أو انقر فوق Select a file لتحديد ملف WSDL محلي.

  5. ضمن Import method، حدد SOAP to REST. عند تحديد هذا الخيار، تحاول APIM إجراء تحويل تلقائي بين XML وJavaScript Object Notation. في هذه الحالة، يجب على المستهلكين استدعاء API باعتباره RESTful API، والذي يقوم بإرجاع JSON. تقوم APIM بتحويل كل طلب إلى مكالمة SOAP.

    لقطة شاشة تعرض خيار SOAP إلى REST.

  6. يتم ملء مربعي الاسم والاسم المعروض تلقائيا بمعلومات من واجهة برمجة تطبيقات SOAP.

    يتم إدخال معلومات الاسم المعروض وعنوان URLوالوصف تلقائيا للعمليات. تتلقى العمليات أيضا اسما أنشأه النظام.

  7. أدخل إعدادات واجهة برمجة التطبيقات الأخرى، ثم حدد إنشاء. يمكنك أيضا تكوين هذه القيم لاحقا عن طريق الانتقال إلى علامة التبويب الإعدادات .

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

اختبار API الجديد في مدخل Microsoft Azure

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

  1. تحديد واجهة برمجة التطبيقات التي أنشأتها في الخطوة السابقة.

  2. حدد علامة التبويب الاختبار.

  3. حدد عملية.

    تعرض الصفحة حقول معلمات الاستعلام وحقول الرؤوس. أحد العناوين هو Ocp-Apim-Subscription-Key. هذا العنوان مخصص لمفتاح الاشتراك للمنتج المقترن بواجهة برمجة التطبيقات هذه. إذا قمت بإنشاء مثيل APIM، فأنت مسؤول بالفعل، لذلك يتم ملء المفتاح تلقائياً.

  4. حدد إرسال.

    عند نجاح الاختبار، تستجيب الواجهة الخلفية بـ 200 OK وبعض البيانات.

إلحاق واجهات برمجة تطبيقات أخرى

يمكنك إنشاء واجهة برمجة تطبيقات من واجهات برمجة التطبيقات التي يتم كشفها بواسطة خدمات مختلفة، بما في ذلك:

  • مواصفات OpenAPI
  • واجهة برمجة تطبيقات SOAP
  • واجهة برمجة تطبيقات GraphQL
  • تطبيق ويب مستضاف في Azure App Service
  • دالات Azure
  • تطبيقات Azure Logic
  • Azure Service Fabric

إشعار

عند استيراد واجهة برمجة تطبيقات، يتم إلحاق العمليات بواجهة برمجة التطبيقات الحالية.

لإلحاق واجهة برمجة تطبيقات بواجهة برمجة تطبيقات موجودة:

  1. انتقل إلى مثيل Azure API Management في مدخل Microsoft Azure:

    لقطة شاشة تعرض صفحة خدمات APIM.

  2. حدد واجهات برمجة التطبيقات في صفحة نظرة عامة على أو حدد واجهات برمجة التطبيقات >واجهات برمجة التطبيقات في القائمة على اليسار.

    لقطة شاشة تعرض تحديد واجهات برمجة التطبيقات في صفحة نظرة عامة.

  3. حدد علامة الحذف (...) بجوار واجهة برمجة التطبيقات التي تريد إلحاق واجهة برمجة تطبيقات أخرى بها.

  4. حدد استيراد من القائمة المنسدلة:

    لقطة شاشة تعرض الأمر استيراد.

  5. حدّد خدمة لاستيراد واجهة برمجة تطبيقات منها.

المحتوى ذو الصلة