مشاركة عبر

كشف واجهات برمجة التطبيقات APIs بدون خادم من نقاط نهاية HTTP باستخدام إدارة واجهة برمجة تطبيقات API Azure

  • مقالة

تتكامل وظائف Azure Functions مع إدارة واجهة برمجة تطبيقات API Azure في المدخل للسماح لك بكشف نقاط نهاية وظيفة مشغل HTTP كـ APIs REST. يتم وصف واجهات برمجة التطبيقات APIs هذه باستخدام تعريف OpenAPI. يحتوي هذا الملف JSON (أو YAML) على معلومات حول العمليات المتوفرة في API. ويتضمن تفاصيل حول كيفية هيكلة بيانات الطلب والاستجابة لواجهة برمجة التطبيقات API. من خلال دمج تطبيق الوظائف الخاص بك، يمكنك أن تقوم إدارة API بإنشاء تعريفات OpenAPI هذه.

توضح هذه المقالة كيفية دمج تطبيق الوظائف مع إدارة API. يعمل هذا التكامل لتطبيقات الوظائف المطورة في أي لغة معتمدة. يمكنك أيضًا استيراد التطبيق وظيفة الخاص بك من إدارة API Azure.

بالنسبة إلى وظائف مكتبة الفئة C#، يمكنك أيضًا استخدام Visual Studio لإنشاء API بدون خادم ونشره يتكامل مع إدارة API.

قم بإنشاء نموذج إدارة واجهة برمجة التطبيقات API

لإنشاء مثيل إدارة API مرتبط بتطبيق الوظيفة:

  1. حدد تطبيق الوظائف، واختر إدارة واجهة برمجة التطبيقات من القائمة اليمنى، ثم حدد إنشاء جديد ضمن إدارة API.

    Choose API Management

  2. استخدم إعدادات إدارة API كما هو محدد في الجدول التالي:

    الإعدادات القيمة المقترحة ‏‏الوصف‬
    الاسم اسم فريد عالميًا يتم إنشاء اسم استنادًا إلى اسم تطبيق الوظائف.
    الاشتراك اشتراكك الاشتراك الذي يتم بموجبه إنشاء هذا تطبيق الوظائف الجديد.
    مجموعة الموارد myResourceGroup نفس المورد مثل التطبيق وظيفة الخاص بك، والتي ينبغي الحصول على تعيين لك.
    Location موقع الخدمة فكر في اختيار نفس الموقع الذي يختاره تطبيق الوظائف.
    اسم المؤسسة Contoso اسم المؤسسة المستخدمة في مدخل المطور وإشعارات البريد الإلكتروني.
    البريد الإلكتروني للمسؤول استخدام بريدك الإلكتروني البريد الإلكتروني الذي تلقى إعلامات النظام من إدارة API.
    مستوى الأسعار الاستهلاك‬ مستوى الاستهلاك غير متوفر في جميع المناطق. للحصول على تفاصيل التسعير الكاملة، راجع صفحة تسعير إدارة API

    Create new API Management service

  3. اختر Export لإنشاء مثيل إدارة API، والذي قد يستغرق عدة دقائق.

  4. بعد Azure بإنشاء المثيل، فإنه يتيح الخيار تمكين التطبيق Application Insights على الصفحة. حدد لإرسال سجلات إلى نفس المكان مثل تطبيق الدالة.

استيراد دالات

بعد إنشاء مثيل إدارة API، يمكنك استيراد نقاط نهاية الدالة التي تم تشغيلها من HTTP. هذا المثال استيراد نقطة نهاية تسمى TurbineRepair.

  1. في صفحة إدارة API، حدد ارتباط API.

  2. يتم فتح وظائف استيراد Azure مع تمييز وظيفة TurbineRepair. اختر "تحديد" للمتابعة.

    Import Azure Functions into API Management

  3. في الصفحة إنشاء جهاز جديد، قم بقبول الإعدادات الافتراضية، ثم حدد "إنشاء".

    Create from Function App

    ينشأ Azure الـAPI للدالة.

تنزيل تعريف OpenAPI

بعد استيراد الدالات الخاصة بك، يمكنك تحميل تعريف OpenAPI من مثيل إدارة API.

  1. حدد "تنزيل تعريف OpenAPI" في أعلى الصفحة.

    Download OpenAPI definition

  2. حفظ ملف JSON الذي تم تنزيله، ثم افتحه. راجع التعريف.

الخطوات التالية

يمكنك الآن تحسين التعريف في API Management في المدخل. يمكنك أيضًا معرفة المزيد حول API Management.

تحرير تعريف OpenAPI في API Management