البرنامج التعليمي لاختبار REST API – نموذج لحالات الاختبار اليدوي
توماس هاميلتون
ما هو اختبار REST API؟
اختبار واجهة برمجة تطبيقات REST هي تقنية اختبار أتمتة الويب مفتوحة المصدر تُستخدم لاختبار واجهات برمجة تطبيقات RESTful لتطبيقات الويب. الغرض من اختبار Rest API هو تسجيل استجابة Rest API عن طريق إرسال طلبات HTTP/S المختلفة للتحقق مما إذا كانت Rest API تعمل بشكل جيد أم لا. يتم إجراء اختبار Rest API بطرق GET وPOST وPUT وDELETE.
Rest تعني Representational State Transfer (نقل الحالة التمثيلية). وهو أسلوب معماري ونهج للتواصل يستخدم في تطوير خدمات الويب. أصبح REST خيارًا منطقيًا لبناء واجهات برمجة التطبيقات. فهو يتيح للمستخدمين الاتصال والتفاعل مع الخدمات السحابية بكفاءة.
واجهة برمجة التطبيقات (API) هي مجموعة من تعليمات البرمجة للوصول إلى تطبيق برمجي قائم على الويب. بعبارة أخرى، هي مجموعة من الأوامر التي يستخدمها برنامج معين للتواصل مع البرامج الأخرى مباشرةً واستخدام وظائفها للحصول على المعلومات. على سبيل المثال، Google يمكن أن يحتوي الموقع الإلكتروني على واجهة برمجة تطبيقات (API) لوظائف متنوعة مثل البحث والترجمة والتقاويم وما إلى ذلك.
بشكل عام، تكون واجهات برمجة التطبيقات (API) كما هو موضح أدناه، فهي تحتوي على اسم الخادم والمسارات وما إلى ذلك
http://<server name>/v1/export/Publisher/Standard_Publisher_Report?format=csv
أنواع طرق API
هناك 4 أنواع رئيسية من اختبار API الأساليب: الحصول على، نشر، حذف، ووضع.
- للحصول على– تُستخدم طريقة GET لـtracاسترجاع المعلومات من الخادم المحدد باستخدام عنوان URI محدد. عند استخدام طلب GET، يجب أن يقتصر علىtracبيانات t ولا ينبغي أن يكون لها أي تأثير آخر على البيانات.
- سأعين- يتم استخدام طلب POST لإنشاء كيان جديد. ويمكن استخدامه أيضًا لإرسال البيانات إلى الخادم، على سبيل المثال، معلومات العميل وتحميل الملفات وما إلى ذلك باستخدام نماذج HTML.
- ضع– إنشاء كيان جديد أو تحديث كيان موجود.
- حذف– إزالة كافة التمثيلات الحالية للمورد الهدف المقدم بواسطة URI.
كيفية اختبار REST API
يتطلب اختبار واجهة برمجة التطبيقات (API) تطبيقًا للتفاعل مع نموذج واجهة برمجة التطبيقات (API) للاختبار. لاختبار واجهة برمجة التطبيقات، تحتاج إلى شيئين،
- أداة/إطار عمل الاختبار لقيادة واجهة برمجة التطبيقات
- قم بتدوين التعليمات البرمجية الخاصة بك لاختبار نموذج REST API
يمكن اختبار حالات اختبار Rest API باستخدام أدوات مثل:
- عميل الراحة المتقدم
- Postman-راحة العميل
- حليقة في لينكس
سنستخدم هنا Advanced Rest Client، فيما يلي خطوات الحصول على Advance Rest Client،
كيفية الحصول على عميل الراحة المتقدم؟
- انتقل إلى البرنامج المساعد في التأليف Google Chromeمتجر الويب
- ابحث عن "Advanced Rest Client" أو انتقل مباشرة اضغط هنا وتثبيت الامتداد
- حدد أيقونة "Advanced Rest Client" ضمن قسم تطبيقات Chrome - chrome://apps/
بمجرد الانتهاء من التثبيت، اتبع الاختبار أدناه للاختبار RESTful API
خطوات اختبار REST API
نحن هنا نستخدم امتداد عميل الراحة في متصفح Chrome. لفهم الأمر بطريقة واضحة، نحن نستخدم واجهة برمجة التطبيقات الوهمية للاختبار.
http://ip.jsontest.com/
الخطوة 1) افتح عميل REST المتقدم
قم بتشغيل التطبيق عميل REST المتقدم (ARC)، بمجرد تثبيته بنجاح.
الخطوة الثانية) أدخل URL واجهة برمجة التطبيقات للاختبار
أدخل نموذج واجهة برمجة تطبيقات REST URL للاختبار في URL مربع الكتابة.
الخطوة 3) حدد طريقة HTTP
حدد الطريقة الخاصة بنوع أساليب HTTP في اختبار API للوصول إلى POST على سبيل المثال
الخطوة 4) توفير مجموعة الرؤوس
قم بتوفير مجموعة الرؤوس في مربع نص الرؤوس. انقر فوق إدراج مجموعة الرؤوس.
الخطوة 5) تأكيد مجموعة الرؤوس
التالي انقر على استخدام هذه المجموعة.
الخطوة 6) توفير محتوى الجسم المطلوب
- انتقل الآن إلى علامة التبويب Body.
- قم بتعيين نوع محتوى النص المطلوب وعرض المحرر، على سبيل المثال نوع محتوى النص: application/json
- عرض المحرر: الإدخال الخام.
- ضمن Payload، قم بتمرير نص طلب واجهة برمجة التطبيقات التجريبية للاختبار في شكل أزواج قيمة المفتاح، على سبيل المثال {{"key1″:"value1″,"key2″:"value2"}. إذا كان ما بعد API، فنحن بحاجة إلى تمرير النص أو المعلمات. سوف نمر تحت الحمولة المحددة.
{"property" : ["Sites"], "report_type" : ["ALL"]}
الخطوة 7) قم بإرسال التفاصيل لبدء الاختبار
- اضغط على زر الإرسال.
- بإمكانك الضغط على زر التفاصيل لرؤية رؤوس الاستجابات.
وفيما يلي تفاصيل الرد:
التحقق من صحة النتائج
بشكل أساسي، بالنسبة لاختبار Web API، نحتاج إلى التحقق من رمز الاستجابة ورسالة الاستجابة ونص الاستجابة.
فيما يلي رموز الاستجابة المتنوعة التي قد يواجهها المرء أثناء اختبار واجهة برمجة التطبيقات.
أداة اختبار REST API
تحديات اختبار API
المشاكل المثيرة للاهتمام بالنسبة للمختبرين أثناء اختبار خدمات REST هي:
- للتأكد من أن أداة الاختبار تقوم بتغيير معلمات استدعاءات واجهة برمجة التطبيقات (API) بطريقة تتحقق من الوظيفة بالإضافة إلى كشف حالات الفشل. ويشمل استكشاف حالة الحدود وتعيين المعلمات المشتركة
- إنشاء مجموعات قيمة معلمات مثيرة للاهتمام للمكالمات ذات معلمتين أو أكثر
- تحديد المحتوى الذي يجب إجراء مكالمات API بموجبه. والتي قد تتضمن تحديد ظروف البيئة الخارجية (الأجهزة الطرفية، الملفات، وما إلى ذلك) بالإضافة إلى البيانات المخزنة داخليًا والتي تؤثر على واجهة برمجة التطبيقات
- تسلسل استدعاءات واجهة برمجة التطبيقات (API) وفقًا للترتيب الذي سيتم به تنفيذ الوظيفة
- لجعل واجهة برمجة التطبيقات (API) تنتج نتائج مفيدة من المكالمات المتتالية.
ملخص
- واجهة برمجة التطبيقات (API) أو واجهة برمجة التطبيقات عبارة عن مجموعة من تعليمات البرمجة للوصول إلى تطبيق برمجي قائم على الويب.
- هناك بشكل أساسي 4 طرق تتضمن اختبار أتمتة REST API مثل GET وPOST وDelete وPUT.
- نحتاج إلى التحقق من رمز الاستجابة ورسالة الاستجابة ونص الاستجابة في حالات اختبار اختبار API.
