استيراد بيانات تعريف SAP OData كواجهة برمجة تطبيقات

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

تصف هذه المقالة كيفية استيراد خدمة OData (بروتوكول البيانات المفتوحة) إلى إدارة API في Azure باستخدام بيانات وصفية OData. المثال التالي يستخدم SAP Gateway Foundation.

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

• استرداد بيانات تعريف OData من خدمة SAP
• استيراد بيانات OData الوصفية إلى Azure API Management، إما مباشرة أو بعد تحويلها إلى مواصفة OpenAPI
• تكوين واجهة برمجة التطبيقات الكامل
• اختبر واجهة برمجة التطبيقات في بوابة Azure

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

• أنشئ نسخة إدارة واجهة برمجة تطبيقات (API).

• نظام SAP وخدمة يتم كشفها ك OData v2 أو v4.

• إذا كانت واجهة SAP الخلفية تستخدم شهادة موقعة ذاتيا (للاختبار)، فقد تحتاج إلى تعطيل التحقق من سلسلة الثقة ل SSL. للقيام بذلك، قم بتكوين خلفية في مثيل APIM الخاص بك:

  1. في بوابة Azure، تحت واجهات برمجة التطبيقات (APIs)، اختر Backends>+ Create backend جديدة.
  2. إضافة عنوان URL مخصص يشير إلى خدمة الواجهة الخلفية ل SAP.
  3. قم بتوسيع قسم المتقدمين ، ثم امسح خانات التحقق من صحة الشهاداتوالتحقق من أسماء الشهادة .

  إشعار

  في سيناريوهات الإنتاج، استخدم الشهادات المناسبة للتحقق من SSL من طرف إلى طرف.

استرداد بيانات تعريف OData من خدمة SAP

استخدم إحدى الطرق التالية لاسترداد بيانات التعريف XML من خدمة SAP. إذا كنت تخطط لتحويل بيانات التعريف XML إلى مواصفات OpenAPI، فاحفظ الملف محليا.

• استخدم عميل بوابة SAP (المعاملة /IWFND/GW_CLIENT).
• قم بإجراء استدعاء HTTP مباشر لاسترداد XML: http://<OData server URL>:<port>/<path>/$metadata.

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

1. في Azure portal، ابحث واختر API Management services:

   

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

   

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

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

• استيراد XML بيانات التعريف كواجهة برمجة تطبيقات OData مباشرة.
• تحويل بيانات التعريف XML إلى مواصفات OpenAPI.

بيانات تعريف OData

استيراد بيانات تعريف OData

1. في قائمة الشريط الجانبي، اخترواجهات برمجةالتطبيقات (APIs>)، ثم اختر + إضافة API.

2. تحت إنشاء من التعريف، اختر بلاطة OData :

   

3. أدخل إعدادات واجهة برمجة التطبيقات. يمكنك تحديث الإعدادات لاحقا بالانتقال إلى علامة التبويب الإعدادات في واجهة برمجة التطبيقات.

   1. في مواصفات OData، أدخل عنوان URL لنقطة نهاية بيانات تعريف OData. عادة ما تكون هذه القيمة عنوان URL لجذر الخدمة، ملحقة ب /$metadata. بدلا من ذلك، حدد ملف OData XML محليا لاستيراده.

   2. أدخل إعدادات إضافية لتكوين واجهة برمجة التطبيقات الخاصة بك. يتم شرح هذه الإعدادات في استيراد ونشر البرنامج التعليمي الأول لواجهة برمجة التطبيقات .

4. حدد إنشاء.

   تتم إضافة واجهة برمجة التطبيقات إلى قائمة واجهات برمجة التطبيقات. تظهر مجموعات الكيانات والدالات التي يتم كشفها في وصف بيانات تعريف OData في علامة تبويب مجموعات الكيانات والوظائف الخاصة بواجهة برمجة التطبيقات.

   

تحديث مخطط OData

يمكنك الوصول إلى محرر في المدخل لعرض مخطط OData لواجهة برمجة التطبيقات. إذا تغيرت واجهة برمجة التطبيقات، يمكنك أيضا تحديث المخطط في APIM من ملف أو نقطة نهاية خدمة OData.

1. في قائمة الشريط الجانبي، تقوم واجهات برمجة التطبيقات ببرمجة>التطبيقات (APIs)، ثم اختر واجهة برمجة تطبيقات OData الخاصة بك.

2. في علامة التبويب Entity sets and functions ، حدد علامة الحذف (...) بجوار مجموعة كيان أو دالة، ثم حدد Edit.

   

3. راجع المخطط. إذا كنت تريد تحديثه، فحدد تحديث من ملف أو تحديث مخطط من نقطة النهاية.

   

اختبار واجهة برمجة تطبيقات OData

1. في قائمة الشريط الجانبي، تقوم واجهات برمجة التطبيقات ببرمجة>التطبيقات (APIs)، ثم اختر واجهة برمجة تطبيقات OData الخاصة بك.

2. في علامة التبويب Entity sets and functions ، حدد علامة الحذف (...) بجوار مجموعة كيان أو دالة، ثم حدد Test.

   

3. في وحدة تحكم الاختبار، أدخل معلمات القالب ومعلمات الاستعلام والعناوين للاختبار، ثم حدد اختبار. لمزيد من المعلومات حول اختبار واجهات برمجة التطبيقات في المدخل، راجع اختبار واجهة برمجة التطبيقات الجديدة في المدخل.

تأمين واجهة برمجة تطبيقات OData

تأمين واجهة برمجة تطبيقات OData من خلال تطبيق نهج المصادقة والتخويل الحالية ونهج التحقق من صحة OData للحماية من الهجمات من خلال طلبات واجهة برمجة تطبيقات OData.

تلميح

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

مواصفات OpenAPI

تحويل بيانات تعريف OData إلى OpenAPI JSON

1. استخدم أداة OASIS مفتوحة المصدر لـ OData v2 أو OData v4، اعتماداً على XML لبيانات التعريف الخاصة بك.

   يحول المثال التالي OData v2 XML لخدمة epm_ref_apps_prod_man_srvالاختبار :

   odata-openapi -p --basePath '/sap/opu/odata/sap/epm_ref_apps_prod_man_srv' \
    --scheme https --host <your IP address>:<your SSL port> \
    ./epm_ref_apps_prod_man_srv.xml
   

   إشعار

   • للاختبار باستخدام ملف XML واحد، يمكنك استخدام محول مستند إلى الويب يستند إلى أداة مفتوحة المصدر.
   • باستخدام الأداة أو المحول المستند إلى الويب، يعد تحديد <عنوان IP>:<منفذ> خادم SAP OData اختيارياً. بدلا من ذلك، أضف هذه المعلومات لاحقا في مواصفات OpenAPI التي تم إنشاؤها أو بعد استيراد الملف إلى APIM.

2. احفظ ملف openapi-spec.json محليا للاستيراد إلى إدارة API.

استيراد مواصفات OpenAPI

1. في قائمة الشريط الجانبي، في قسم واجهات البرمجة (APIs )، اختر واجهات برمجة التطبيقات (APIs).

2. تحت إنشاء من التعريف، اختر بلاطة OpenAPI :

   

3. اختر اختيار ملف، ثم اختر الملف openapi-spec.json الذي حفظته محليا في خطوة سابقة.

4. أدخل إعدادات واجهة برمجة التطبيقات. يمكنك تعيين هذه القيم عند استيراد واجهة برمجة التطبيقات أو تكوينها لاحقا عن طريق الانتقال إلى علامة التبويب الإعدادات .

   • بالنسبة للاحقة عنوان URL لواجهة برمجة التطبيقات، نوصي باستخدام نفس مسار URL مثل مسار خدمة SAP الأصلية.

   • لمزيد من المعلومات بشأن إعدادات API، راجع استيراد ونشر أول API تعليمي.

5. حدد إنشاء.

إشعار

للحصول على معلومات حول قيود استيراد واجهة برمجة التطبيقات، راجع قيود استيراد واجهة برمجة التطبيقات والمشكلات المعروفة.

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

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

• GET /$metadata

  العملية	‏‏الوصف	تكوين إضافي للعملية
  GET /$metadata	تمكين إدارة واجهة برمجة التطبيقات من الوصول $metadata إلى نقطة النهاية، المطلوبة لتكامل العميل مع خادم OData. هذه العملية المطلوبة غير مضمنة في مواصفات OpenAPI التي أنشأتها واستوردتها.	إضافة 200 OK استجابة.

  

• HEAD /

  العملية	‏‏الوصف
  HEAD /	تمكين العميل من تبادل الرموز المميزة لتزوير الطلب عبر المواقع (CSRF) مع خادم SAP عند الحاجة. يسمح SAP أيضا بتبادل الرمز المميز CSRF عبر فعل GET. لم يتم تغطية تبادل الرمز المميز لـ CSRF في هذه المقالة. راجع مقتطف سياسة إدارة واجهة برمجة التطبيقات مثال لسوق التوكن.

  

• GET /

  العملية	‏‏الوصف	تكوين إضافي للعملية
  GET /	تمكين تكوين النهج في جذر الخدمة.	قم بتكوين نهج rewrite-uri الوارد التالي لإلحاق شرطة مائلة زائدة بالطلبات التي تتم إعادة توجيهها إلى جذر الخدمة: <rewrite-uri template="/" copy-unmatched-params="true" /> يزيل هذا النهج الغموض المحتمل بين الطلبات مع الشرطة المائلة اللاحقة وبدونها. يتم التعامل مع هذين النوعين من الطلبات بشكل مختلف من قبل بعض الخلفيات.

  

تحتاج أيضا إلى تكوين المصادقة إلى الخلفية باستخدام أسلوب مناسب للبيئة الخاصة بك. لأمثلة على ذلك، انظر المصادقة والتفويض.

قم باختبار واجهة برمجة التطبيقات الخاصة بك

1. انتقل إلى مثيل APIM الخاص بك.

2. في قائمة الشريط الجانبي، اخترواجهات برمجةالتطبيقات (APIs>).

3. ضمن جميع واجهات برمجة التطبيقات، حدد واجهة برمجة تطبيقات المستوردة الخاصة بك.

4. حدد علامة تبويب اختبار للوصول إلى وحدة الاختبار.

5. حدد عملية، وأدخل أي قيم مطلوبة، ثم حدد إرسال.

   على سبيل المثال، اختبر GET /$metadata الاستدعاء للتحقق من الاتصال بواجهة SAP الخلفية.

6. عرض الاستجابة. لاستكشاف الأخطاء وإصلاحها، تتبع المكالمة.

7. عند الانتهاء من الاختبار، قم بإنهاء وحدة تحكم الاختبار.

اعتبارات الإنتاج

• راجع مثالا لسيناريو شامل لدمج إدارة واجهة برمجة التطبيقات مع بوابة SAP.
• التحكم في الوصول إلى واجهة SAP الخلفية باستخدام نهج APIM. على سبيل المثال، إذا تم استيراد واجهة برمجة التطبيقات كواجهة برمجة تطبيقات OData، فاستخدم نهج طلب التحقق من صحة OData. هناك أيضا مقتطفات سياسات ل SAP الانتشار الرئيسي ل SAP ECC أو S/4HANA أو SAP SuccessFactors وجلب رمز X-CSRF.
• للحصول على إرشادات حول نشر واجهات برمجة التطبيقات وإدارتها وترحيلها على نطاق واسع، راجع:
  • عمليات نشر API آلية باستخدام APIOps
  • استخدم DevOps وCI/CD لنشر واجهات برمجة التطبيقات

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

• قيود استيراد API
• استيراد مواصفة OpenAPI
• استيراد واجهة برمجة تطبيقات SOAP
• استيراد واجهة برمجة تطبيقات SOAP وتحويلها إلى REST
• استيراد واجهة برمجة تطبيقات App Service
• استيراد واجهة برمجة تطبيقات تطبيق حاوية
• استيراد واجهة برمجة تطبيقات WebSocket
• استيراد واجهة برمجة تطبيقات GraphQL
• استيراد مخطط GraphQL وإعداد محللات الحقول
• استيراد واجهة برمجة تطبيقات تطبيق دالة
• استيراد واجهة برمجة تطبيقات تطبيق منطقي
• استيراد خدمة Service Fabric
• استيراد واجهة برمجة تطبيقات Microsoft Foundry
• استيراد واجهة برمجة تطبيقات Azure OpenAI
• استيراد واجهة برمجة تطبيقات LLM
• استيراد واجهة برمجة تطبيقات OData
• تصدير واجهة برمجة تطبيقات REST كخادم MCP
• كشف خادم MCP موجود
• استيراد واجهة برمجة تطبيقات وكيل A2A
• استيراد بيانات التعريف لـ SAP OData
• استيراد واجهة برمجة تطبيقات gRPC
• تحرير واجهة برمجة تطبيقات