اكتشف خدمة APIM
توفر إدارة واجهة برمجة التطبيقات عناصر الكفاءات الأساسية لضمان نجاح برنامج API عن طريق تفاعل المُطوِّرين وتقديم نتائج التحليلات المعرفية للأعمال والتحليلات وجوانب الأمان والحماية. تتكون كل واجهة برمجة تطبيقات من عملية واحدة أو أكثر، ويمكن إضافة كل واجهة برمجة تطبيقات إلى منتج واحد أو أكثر. لاستخدام واجهة برمجة تطبيقات، يشترك المطورون في منتج يحتوي على واجهة برمجة التطبيقات هذه، ثم يمكنهم استدعاء عملية واجهة برمجة التطبيقات، رهنا بأي نهج استخدام.
مكونات APIM
تتكون APIM من بوابة API ومستوى الإدارة وبوابة مطور. هذه المكونات مستضافة في Azure وتتم إدارتها بالكامل بشكل افتراضي. تتوفر APIM في مستويات مختلفة تختلف في السعة والميزات.
بوابة API هي نقطة النهاية التي:
- قبول استدعاءات واجهة برمجة التطبيقات وتوجيهها إلى الخلفيات المناسبة
- التحقق من مفاتيح واجهة برمجة التطبيقات وبيانات الاعتماد الأخرى المقدمة مع الطلبات
- يفرض حصص الاستخدام وحدود الأسعار
- تحويل الطلبات والاستجابات المحددة في عبارات النهج
- تخزين الاستجابات مؤقتا لتحسين زمن انتقال الاستجابة وتقليل الحمل على خدمات الواجهة الخلفية
- تصدر سجلات ومقاييس وتتبعات للمراقبة وإعداد التقارير واستكشاف الأخطاء وإصلاحها
مستوى الإدارة هو الواجهة الإدارية حيث تقوم بإعداد برنامج API الخاص بك. استخدمها في:
- توفير وتكوين إعدادات خدمة APIM
- تعريف مخطط واجهة برمجة التطبيقات أو استيراده
- حزم واجهات برمجة التطبيقات في المنتجات
- أعد سياسات مثل الحصص أو التحويلات على واجهات برمجة التطبيقات
- احصل على رؤى من التحليلات
- إدارة المستخدمين
مدخل المطور هو موقع ويب يتم إنشاؤه تلقائيا وقابل للتخصيص بالكامل مع وثائق واجهات برمجة التطبيقات الخاصة بك. باستخدام بوابة المطور، يمكن للمطورين القيام بما يلي:
- اقرأ وثائق واجهة برمجة التطبيقات
- استدعاء واجهة برمجة التطبيقات عبر وحدة التحكم التفاعلية
- قم بإنشاء حساب واشترك للحصول على مفتاح API
- الوصول إلى التحليلات على استخدامهم الخاص
- تحميل تعريفات API
- إدارة مفاتيح API
المنتجات
المنتجات هي كيفية ظهور واجهات برمجة التطبيقات للمطورين. تحتوي المنتجات في API Management على واجهات برمجة تطبيقات واحدة أو أكثر، ويتم تكوينها بعنوان ووصف وشروط استخدام. يمكن أن تكون المنتجات مفتوحة أو محمية. يجب الاشتراك في المنتجات المحمية قبل استخدامها، في حين يمكن استخدام المنتجات المفتوحة دون اشتراك. يتم تكوين الموافقة على الاشتراك على مستوى المنتج ويمكن أن تتطلب موافقة المسؤول أو أن يتم الموافقة عليها تلقائيا.
المجموعات
يتم استخدام المجموعات لإدارة رؤية المنتجات للمطورين. إدارة API لديها مجموعات النظام غير القابلة للتغيير التالية:
- المسؤولون - إدارة مثيلات خدمة APIM، وإنشاء واجهات برمجة التطبيقات، والعمليات والمنتجات التي يستخدمها المطورون. مسؤولو اشتراك Azure هم أعضاء في هذه المجموعة.
- المطورون - مستخدمو بوابة المطورين المعتمدين الذين ينشئون تطبيقات باستخدام واجهات برمجة التطبيقات الخاصة بك. يتم منح المطورين حق الوصول إلى مدخل المطور وبناء التطبيقات التي تستدعي عمليات API.
- الضيوف - مستخدمو مدخل المطور غير المصادق عليهم. يمكن منحهم وصولا معينا للقراءة فقط، مثل القدرة على عرض واجهات برمجة التطبيقات ولكن ليس استدعاؤها.
بالإضافة إلى مجموعات النظام هذه، يمكن للمسؤولين إنشاء مجموعات مخصصة أو استخدام مجموعات خارجية في مستأجري Microsoft Entra المقترنين.
المطورون
يمثل المطورون حسابات المستخدمين في مثيل خدمة إدارة API. يمكن إنشاء المطورين أو دعوتهم للانضمام من قبل المسؤولين، أو يمكنهم الاشتراك من بوابة المطور. كل مطور عضو في مجموعة واحدة أو أكثر، ويمكنه الاشتراك في المنتجات التي تمنح رؤية لتلك المجموعات.
السياسات
المعايير هي مجموعة من العبارات التي يتم تنفيذها بالتسلسل بناءً على طلب أو استجابة واجهة برمجة التطبيقات. تتضمن البيانات الشائعة تحويل التنسيق من XML إلى JSON، ومعدل الاتصال الذي يحد من عدد المكالمات الواردة من مطور، وتتوفر العديد من السياسات الأخرى.
يمكن استخدام تعبيرات النهج كقيم سمة أو قيم نصية في أي من نهج إدارة API، ما لم يحدد النهج خلاف ذلك. تستند بعض النهج مثل تدفق التحكم و تعيين نهج المتغيرات إلى تعبيرات النهج.
يمكن تطبيق النهج في نطاقات مختلفة، اعتمادًا على احتياجاتك: عمومي (جميع واجهات برمجة التطبيقات) أو منتج أو واجهة برمجة تطبيقات محددة أو عملية واجهة برمجة تطبيقات.