البرنامج التعليمي: استجابات Mock API

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

يمكن استيراد واجهات برمجة التطبيقات الخلفية إلى واجهة برمجة تطبيقات Azure لإدارة API أو إنشاؤها وإدارتها يدويا. تصف الخطوات الواردة في هذا البرنامج التعليمي كيفية:

• استخدم API Management لإنشاء واجهة برمجة تطبيقات HTTP فارغة.
• إدارة واجهة برمجة تطبيقات HTTP يدويا.
• تعيين نهج على واجهة برمجة تطبيقات بحيث تقوم بإرجاع استجابة وهمية.

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

تلميح

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

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

• عندما يتم تصميم بوابة API أولا ويتم تنفيذ الخلفية لاحقا، أو عندما يتم تطوير الخلفية بالتوازي.
• عندما يكون الخلفية غير نشطة مؤقتا أو غير قادرة على التوسع.

في هذا البرنامج التعليمي، تتعلم كيفية:

• إنشاء API تجريبي
• إضافة عملية إلى اختبار API
• تفعيل استجابة الاستنساخ
• اختبار API المُستنسخة

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

• تعرف على مصطلحات APIM.
• فهم مفهوم النهج في APIM.
• أكمل التشغيل السريع إنشاء مثيل إدارة واجهة برمجة تطبيقات Azure.

إنشاء API تجريبي

توضح الخطوات الواردة في هذا القسم طريقة إنشاء واجهة برمجة تطبيقات HTTP بدون خلفية.

1. سجل الدخول إلى بوابة Azure، ثم انتقل إلى مثيل إدارة واجهة برمجة التطبيقات الخاص بك.

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

   

3. في نافذة Create an HTTP API، حدد Full.

4. في Display name، أدخل Test API. يمتلئ حقل الاسم تلقائيا.

5. في المنتجات، حدد غير محدود، إذا كانت هذه القيمة متوفرة. تتوفر هذه القيمة فقط في بعض المستويات. يمكنك ترك القيمة فارغة لهذا البرنامج التعليمي، ولكن تحتاج إلى إقران واجهة برمجة التطبيقات بمنتج لنشره. لمزيد من المعلومات، راجع استيراد ونشر واجهة برمجة التطبيقات الأولى.

6. في Gateways، حدد Managed إذا كان هذا الخيار متوفرا. (يتوفر هذا الخيار فقط في مستويات خدمة معينة.)

7. حدد إنشاء.

   

إضافة عملية إلى اختبار API

يكشف API عملية واحدة أو أكثر. في هذا القسم، يمكنك إضافة عملية إلى واجهة برمجة تطبيقات HTTP التي أنشأتها. استدعاء العملية بعد إكمال الخطوات الواردة في هذا القسم يؤدي إلى حدوث خطأ. بعد إكمال الخطوات في قسم تمكين نسخ الاستجابة ، لن تحصل على خطأ.

بوابة

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

2. تحديد + Add Operation.

3. في نافذة الواجهة الأمامية ، أدخل القيم التالية:

   الإعداد	قيمة	‏‏الوصف
   ‏‫اسم العرض‬	اختبار المكالمة	الاسم المعروض في بوابة المطورين.
   الاسم	اختبار النداء	هذا الحقل يمتلئ تلقائيا.
   عنوان URL (المربع الأول)	حصل	تحديد أحد أفعال "HTTP" المحددة مسبقاً.
   URL (المربع الثاني)	/اختبر	مسار "URL" لـ API.
   الوصف		وصف اختياري للعملية. يوفر وثائق في مدخل المطور للمطورين الذين يستخدمون واجهة برمجة التطبيقات.

   

4. حدد علامة التبويب الردود ، الموجودة ضمن مربعات URLواسم العرضوالوصف . أدخل القيم في هذا التبويب لتعريف رموز حالة الاستجابة، وأنواع المحتوى، والأمثلة، والمخططات.

5. حدد + Add response، ثم حدد 200 OK من القائمة.

   

6. في قسم التمثيلات ، حدد + إضافة تمثيل.

7. أدخل application/json في مربع البحث ثم حدد نوع محتوى application/json .

8. في المربع عينة ، أدخل { "sampleField" : "test" }.

9. حدد حفظ.

   

على الرغم من أنه غير مطلوب لهذا المثال، يمكنك تكوين المزيد من الإعدادات لعملية API على علامات تبويب أخرى، كما هو موضح في الجدول التالي:

علامة التبويب	‏‏الوصف
استفسار	إضافة معلمات الاستعلام. بالإضافة إلى توفير اسم ووصف، يمكن أيضًا توفير القيم التي عُينت لمعامل الاستعلام. يمكنك وضع علامة على إحدى القيم على أنها افتراضية (اختياري).
طلب	تحديد أنواع محتوى الطلب والأمثلة والمخططات.

Azure CLI

للبدء في استخدام Azure CLI:

• استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع بدء استخدام Azure Cloud Shell.

  

• إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.

  • إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات تسجيل الدخول الأخرى، راجع المصادقة على Azure باستخدام Azure CLI.

  • عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات حول الملحقات، راجع استخدام الملحقات وإدارتها باستخدام Azure CLI.

  • يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.

لإضافة عملية إلى اختبار API الخاص بك، يلزم تشغيل الأمر az apim api operation create:

az apim api operation create --resource-group <resource-group> \
    --display-name "Test call" --api-id test-api --method GET \
    --url-template /test --service-name <API-management-service-name> 

تشغيل الأمر az apim api operation list لمشاهدة جميع العمليات الخاصة بـ API:

az apim api operation list --resource-group <resource-group-name> \
    --api-id test-api --service-name <API-management-service-name> --output table

الاحتفاظ بهذه العملية لاستخدامها في بقية هذه المقالة. إذا كنت ترغب في إزالة عملية، يمكنك استخدام الأمر az apim api operation delete . احصل على معرف العملية من الأمر السابق.

az apim api operation delete --resource-group <resource-group-name> \
    --api-id test-api --operation-id <ID> \
    --service-name <API-management-service-name>

تفعيل استجابة الاستنساخ

1. تحديد API التي أنشأتها في Create a test API.

2. تأكد من تحديد علامة التبويب تصميم .

3. اختر عملية استدعاء الاختبار التي أضفتها.

4. في القسم المعالجة الواردة، حدد + Add policy.

   

5. حدد تجانب الاستجابات الوهمية من المعرض:

   

6. تأكد من ظهور 200 OK، application/json في مربع استجابة APIM . يشير هذا التحديد إلى أن واجهة برمجة التطبيقات يجب أن ترجع نموذج الاستجابة الذي قمت بتعريفه في القسم السابق.

   

7. حدد حفظ.

   تلميح

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

اختبار API المُستنسخة

1. تحديد API التي أنشأتها في Create a test API.

2. في علامة التبويب Test ، تأكد من تحديد Test call API، ثم حدد Send لإجراء مكالمة اختبار:

   

3. تعرض استجابة HTTP JSON المقدمة كعينة في القسم الأول من البرنامج التعليمي:

   

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

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