مشاركة عبر

استيراد واجهة برمجة تطبيقات gRPC

  • مقالة

ينطبق على: المطور | قسط

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

لإضافة واجهة برمجة تطبيقات gRPC إلى APIM، تحتاج إلى:

  • تحميل ملف تعريف Protobuf (المخزن المؤقت للبروتوكول) إلى API Management
  • تحديد موقع خدمة gRPC
  • تكوين واجهة برمجة التطبيقات في APIM

تدعم APIM التمرير مع الأنواع التالية من أساليب خدمة gRPC: أحادي، وتدفق الخادم، وتدفق العميل، والتدفق ثنائي الاتجاه. للحصول على خلفية حول gRPC، راجع مقدمة إلى gRPC.

إشعار

  • حاليا، يتم دعم واجهات برمجة تطبيقات gRPC فقط في البوابة المستضافة ذاتيا، وليس البوابة المدارة لمثيل APIM الخاص بك.
  • حاليا، اختبار واجهات برمجة تطبيقات gRPC غير مدعوم في وحدة تحكم الاختبار في مدخل Microsoft Azure أو في مدخل مطور APIM.
  • يقتصر الاستيراد على ملف Protobuff واحد (.proto).

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

  • مثيل API Management. إذا لم يكن لديك واحد بالفعل، فأكمل التشغيل السريع التالي: إنشاء مثيل إدارة واجهة برمجة تطبيقات Azure.

  • مورد بوابة تم توفيره في المثيل الخاص بك. إذا لم يكن لديك بوابة بالفعل، فشاهد توفير بوابة مستضافة ذاتيا في Azure API Management.

  • ملف gRPC Protobuff (.proto) متوفر محليا وخدمة gRPC التي يمكن الوصول إليها عبر HTTPS.

إضافة واجهة برمجة تطبيقات gRPC

  1. في مدخل Azure، انتقل إلى مثيل API Management الخاص بك.

  2. في القائمة اليسرى، حدد APIs>+ Add API.

  3. ضمن تعريف واجهة برمجة تطبيقات جديدة، حدد gRPC.

    لقطة شاشة لإنشاء واجهة برمجة تطبيقات gRPC في المدخل.

  4. في نافذة Create a gRPC API، حدد Full.

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

    1. في Upload schema، حدد ملف .proto محليا مقترنا بواجهة برمجة التطبيقات لاستيراده.

    2. في عنوان URL لخادم gRPC، أدخل عنوان خدمة gRPC. يجب أن يكون العنوان متاحا عبر HTTPS.

    3. في Gateways، حدد مورد البوابة الذي تريد استخدامه لعرض واجهة برمجة التطبيقات.

      هام

      في المعاينة العامة، يمكنك فقط تحديد بوابة ذاتية الاستضافة. البوابة المدارة غير مدعومة.

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

  7. حدد إنشاء.

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

استدعاء خدمات gRPC باستخدام .NET

للحصول على معلومات حول استدعاء خدمات gRPC باستخدام .NET، راجع المقالات التالية:

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

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

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

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

إشعار

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

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

    الانتقال إلى مثيل Azure API Mgmt

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

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

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

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

    حدد استيراد

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

    تحديد خدمة