إنشاء بوابة API

مكتمل

وكثيرًا ما تحتاج المؤسسات إلى تمديد الشركاء بإمكانية الوصول إلى البيانات. ويجب مراقبة هذا الوصول وإدارته.

وفي مثال شركة الأحذية، فإنه يجب على تجار التجزئة الذين يقومون بتخزين أحذية ”NorthWind“ أن يعرفوا كم من المخزون يمكن أن يطلبوا. يرغب العملاء أيضاً في معرفة متى سيحصلون على طلباتهم بالضبط.

هنا، يمكنك معرفة كيفية عمل Azure API Management، وكيفية إعداد بوابة API.

إدارة Azure API

تتم استضافة خدمة إدارة واجهة برمجة تطبيقات Azure في سحابة Azure ويتم وضعها بين واجهات برمجة التطبيقات والإنترنت. يعمل مثيل API Management كبوابة Azure API.

فعند نشر واجهات برمجة التطبيقات ”API“ الخاصة بك، يمكنك استخدام مدخل Microsoft Azure لكي تتحكم في كيفية عرض واجهات برمجة التطبيقات ”APIs“ الخاصة بالمستهلكين. قد ترغب في إتاحة بعض واجهات برمجة التطبيقات ”APIs“ مجانًا للمطورين، لأغراض العرض التوضيحي، والوصول إلى واجهات برمجة التطبيقات ”APIs“ الأخرى التي تتم مراقبتها بإحكام.

لماذا تقوم باستخدام APIM؟

بالنسبة إلى المطورين، تقوم APIM بتوفير مجموعة من المزايا.

  • وثائق واجهة برمجة التطبيقات. تقوم مستندات APIs بتمكين الاتصال بالعملاء لدمج حلولهم بشكل سريع. تتيح لك إدارة واجهة برمجة التطبيقات الكشف بسرعة عن بنية واجهة برمجة التطبيقات الخاصة بك لاستدعاء العملاء من خلال معايير حديثة مثل OpenAPI. يمكنك امتلاك أكثر من إصدار من API. مع الإصدارات المتعددة، يمكنك إعداد التحديثات التطبيقية حيث إن تطبيقاتك المستهلكة لا تحتاج إلى استخدام النسخة الجديدة مباشرة.
  • المعدل الذي يحد من الوصول. إذا كان API الخاص بك يمكنه الحصول على كمية كبيرة من البيانات، فيكون جيدًا للحد من المعدل الذي يمكن أن يطلب به العملاء البيانات. ويساعد معدل الحد في الحفاظ على أوقات الاستجابة المثلى لكل عميل. تتيح لك إدارة واجهة برمجة التطبيقات تعيين حدود السعر ككل أو لعملاء فرديين محددين.
  • المراقبة الصحية. يستهلك العملاء عن بعد واجهات برمجة التطبيقات الخاصة بك، لذلك قد يكون من الصعب تحديد المشاكل أو الأخطاء المحتملة. وتتيح لك APIM عرض أخطاء وملفات السجلات، والمرشحات حسب أنواع الردود.
  • تنسيقات حديثة مثل JSON. وقد استخدمت APIs العديد من تنسيقات تبادل البيانات المختلفة على مر السنين من ”XML“ إلى ”CSV“ وأكثر. تقوم APIM بتمكينك من كشف هذه التنسيقات باستخدام نماذج البيانات الحديثة مثل JSON.
  • الاتصال إلى أي واجهة برمجة تطبيقات. في العديد من الشركات، توجد واجهات برمجة التطبيقات عبر بلدان/مناطق مختلفة وتستخدم تنسيقات مختلفة. تتيح لك APIM إضافة كل واجهات برمجة التطبيقات المتباينة هذه في واجهة واحدة حديثة.
  • تحليلات. وفي أثناء تطويرك لواجهات برمجة التطبيقات ” APIs“ الخاصة بك، فمن المفيد معرفة مرات اتصال واجهات برمجة التطبيقات ”APIs“ الخاصة بك وأنواع الأنظمة. وتتيح لك APIM تصور هذه البيانات مدخل Microsoft Azure.
  • الأمان. ويعد الأمن ذات أهمية عند التعامل مع بيانات النظام. فالانتهاكات غير المصرح بها من الممكن أن تكلف الشركات أموالاً والوقت الضائع في قانون إعادة العمل، والخسارة في السمعة. تتضمن أدوات الأمان التي يمكنك استخدامها مع إدارة واجهة برمجة تطبيقات Azure تخويل مستخدم OAuth 2.0 والتكامل مع معرف Microsoft Entra.
  • مستويات التسعير. توفر APIM مستويات ذات قدرات مختلفة لمعدل نقل الطلب واتفاقية مستوى الخدمة وعزل الشبكة ومرونة الترقية وما إلى ذلك. عند إنشاء بوابة إدارة واجهة برمجة تطبيقات Azure، يمكنك اختيار المستوى الذي يلبي احتياجاتك.

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

لكي تقوم بإنشاء إدارة، يمكنك:

  1. إنشاء بوابة API Management. يجب أن يكون الاسم الذي تستخدمه للبوابة فريداً من نوعه ويكون داخل مساحة الاسم azure-api.net.
  2. تسجيل واجهة برمجة تطبيقات ويب موجودة مع البوابة. تسجيل API يجعل API متوفرة للعملاء في نقطة النهاية <بوابة> azure-api.net.
  3. قم بالاتصال بـ API الموجودة من خلال البوابة. يمكن للمستهلكين الآن استدعاء واجهة برمجة التطبيقات في عنوان URL لنقطة النهاية.