Postman البرنامج التعليمي - كيفية استخدامه لاختبار واجهة برمجة التطبيقات (API)؟

ما هي تفاصيل Postman?

Postman هي أداة اختبار واجهة برمجة التطبيقات (API) قابلة للتطوير والتي تتكامل بسرعة مع خط أنابيب CI/CD. لقد بدأ في عام 2012 كمشروع جانبي بواسطة Abhinav Asthana لتبسيط سير عمل واجهة برمجة التطبيقات (API) في الاختبار والتطوير. API تعني واجهة برمجة التطبيقات التي تسمح لتطبيقات البرامج بالتواصل مع بعضها البعض عبر مكالمات API.

لماذا الاستخدام Postman?

مع أكثر من 4 ملايين مستخدم في الوقت الحاضر، Postman لقد أصبح البرنامج أداة مفضلة للمتابعةwing الأسباب:

  1. إمكانية الوصول - للاستخدام Postman الأداة، سيحتاج المرء فقط إلى تسجيل الدخول إلى حساباته الخاصة مما يجعل من السهل الوصول إلى الملفات في أي وقت وفي أي مكان طالما Postman يتم تثبيت التطبيق على جهاز الكمبيوتر.
  2. استخدام المجموعات – Postman يتيح للمستخدمين إنشاء مجموعات خاصة بهم Postman مكالمات API. يمكن لكل مجموعة إنشاء مجلدات فرعية وطلبات متعددة. وهذا يساعد في تنظيم مجموعات الاختبار الخاصة بك.
  3. التعاون – يمكن استيراد المجموعات والبيئات أو تصديرها مما يسهل مشاركة الملفات. يمكن أيضًا استخدام رابط مباشر لمشاركة المجموعات.
  4. إنشاء البيئات - يساعد وجود بيئات متعددة في تقليل تكرار الاختبارات حيث يمكن للمرء استخدام نفس المجموعة ولكن لبيئة مختلفة. هذا هو المكان الذي ستتم فيه عملية تحديد المعلمات، وهو ما سنناقشه في المزيد من الدروس.
  5. إنشاء الاختبارات – يمكن إضافة نقاط فحص الاختبار مثل التحقق من حالة استجابة HTTP الناجحة إلى كل منها Postman مكالمات API التي تساعد على ضمان تغطية الاختبار.
  6. اختبار الأتمتة – من خلال استخدام Collection Runner أو Newman، يمكن تشغيل الاختبارات في تكرارات متعددة مما يوفر الوقت للاختبارات المتكررة.
  7. التصحيح – Postman تساعد وحدة التحكم في التحقق من البيانات التي تم استردادها مما يسهل تصحيح الاختبارات.
  8. التكامل المستمر – مع قدرتها على دعم التكامل المستمر، يتم الحفاظ على ممارسات التطوير.

طريقة الاستخدام Postman لتنفيذ واجهات برمجة التطبيقات

وفيما يلي Postman مساحة العمل. دعنا نستكشف العملية خطوة بخطوة طريقة الاستخدام Postman ومميزات مختلفة Postman أداة!

طريقة الاستخدام
 Postman لتنفيذ واجهات برمجة التطبيقات

  1. جديد – هذا هو المكان الذي ستقوم فيه بإنشاء طلب أو مجموعة أو بيئة جديدة.
  2. الاستيراد - يُستخدم لاستيراد مجموعة أو بيئة. هناك خيارات مثل الاستيراد من ملف أو مجلد أو رابط أو لصق نص خام.
  3. Runner – يمكن تنفيذ اختبارات الأتمتة من خلال Collection Runner. سيتم مناقشة هذا الأمر بشكل أكبر في الدرس التالي.
  4. فتح جديد – فتح علامة تبويب جديدة، Postman نافذة أو نافذة عداء بالنقر فوق هذا الزر.
  5. مساحة العمل الخاصة بي – يمكنك إنشاء مساحة عمل جديدة بشكل فردي أو كفريق.
  6. دعوة – التعاون في مساحة العمل من خلال دعوة أعضاء الفريق.
  7. التاريخ - سيتم عرض الطلبات السابقة التي أرسلتهاyed في التاريخ. وهذا يجعل من السهل تتبع الإجراءات التي قمت بها.
  8. المجموعات – قم بتنظيم مجموعة الاختبار الخاصة بك عن طريق إنشاء المجموعات. قد تحتوي كل مجموعة على مجلدات فرعية وطلبات متعددة. يمكن أيضًا تكرار الطلب أو المجلد أيضًا.
  9. علامة تبويب الطلب – يعرض هذا عنوان الطلب الذي تعمل عليه. افتراضيًا، سيتم عرض "طلب بدون عنوان".yed للطلبات بدون عناوين.
  10. طلب HTTP - سيؤدي النقر فوق هذا إلى عرض قائمة منسدلة للطلبات المختلفة مثل GET وPOST وCOPY وDELETE وما إلى ذلك. Postman اختبار واجهة برمجة التطبيقات (API)، الطلبات الأكثر استخدامًا هي GET وPOST.
  11. عنوان URL للطلب – يُعرف أيضًا باسم نقطة النهاية، حيث ستحدد الرابط الذي ستتواصل معه واجهة برمجة التطبيقات (API).
  12. حفظ - إذا كانت هناك تغييرات على الطلب، فإن النقر فوق "حفظ" أمر ضروري حتى لا يتم فقدان التغييرات الجديدة أو الكتابة فوقها.
  13. Params – هذا هو المكان الذي ستكتب فيه المعلمات المطلوبة لطلب مثل القيم الأساسية.
  14. التفويض - من أجل الوصول إلى واجهات برمجة التطبيقات، يلزم الحصول على التفويض المناسب. قد يكون على شكل اسم مستخدم وكلمة مرور، أو رمز حامل، وما إلى ذلك.
  15. الرؤوس - يمكنك تعيين الرؤوس مثل نوع المحتوى JSON وفقًا لاحتياجات المؤسسة.
  16. الجسم – هذا هو المكان الذي يمكن للمرء تخصيصهtails في طلب شائع الاستخدام في طلب POST.
  17. البرنامج النصي للطلب المسبق – ​​هذه هي البرامج النصية التي سيتم تنفيذها قبل الطلب. عادةً ما يتم استخدام البرامج النصية للطلب المسبق لبيئة الإعداد لضمان تشغيل الاختبارات في البيئة الصحيحة.
  18. الاختبارات - هذه هي البرامج النصية التي يتم تنفيذها أثناء الطلب. من المهم إجراء اختبارات لأنها تقوم بإعداد نقاط تفتيش للتحقق مما إذا كانت حالة الاستجابة على ما يرام، وأن البيانات المستردة كما هو متوقع وغيرها من الاختبارات.

العمل مع طلبات GET

يتم استخدام طلبات الحصول على المعلومات من عنوان URL المحدد. لن يتم إجراء أي تغييرات على نقطة النهاية.

سوف نستخدم فولوwing عنوان URL لجميع الأمثلة في هذا Postman البرنامج التعليمي https://jsonplaceholder.typicode.com/users

في مساحة العمل

  1. قم بتعيين طلب HTTP الخاص بك على GET.
  2. في حقل عنوان URL للطلب، أدخل الرابط
  3. انقر فوق إرسال
  4. سترى 200 رسالة موافق
  5. يجب أن يكون هناك 10 نتائج مستخدم في النص تشير إلى أن الاختبار قد تم تشغيله بنجاح.

العمل مع الحصول على الطلبات

* ملاحظة: قد تكون هناك حالات تحصل عليها Postman قد يكون الطلب غير ناجح. يمكن أن يكون ذلك بسبب عنوان URL غير صالح للطلب أو أن المصادقة مطلوبة.

العمل مع طلبات POST

تختلف طلبات النشر عن طلب الحصول على حيث يوجد معالجة للبيانات حيث يقوم المستخدم بإضافة البيانات إلى نقطة النهاية. باستخدام نفس البيانات من البرنامج التعليمي السابق في الحصول على الطلب، فلنضيف الآن المستخدم الخاص بنا.

الخطوة 1) انقر فوق علامة تبويب جديدة لإنشاء طلب جديد.

العمل مع طلبات النشر

الخطوة 2) في علامة التبويب الجديدة

  1. قم بتعيين طلب HTTP الخاص بك إلى POST.
  2. أدخل نفس الرابط في عنوان URL للطلب: https://jsonplaceholder.typicode.com/users
  3. قم بالتبديل إلى علامة التبويب "النص الأساسي".

العمل مع طلبات النشر

الخطوة 3) في الجسم،

  1. انقر فوق الخام
  2. حدد JSON

العمل مع طلبات النشر

الخطوة 4) انسخ والصق نتيجة مستخدم واحدة فقط من طلب الحصول السابق كما هو موضح أدناه. تأكد من نسخ الكود بشكل صحيح باستخدام الأقواس المتعرجة المقترنة و brackets. قم بتغيير المعرف إلى 11 والاسم إلى أي اسم مرغوب فيه. يمكنك أيضًا تغيير دي أخرىtails مثل العنوان.

[
    {
        "id": 11,
        "name": "Krishna Rungta",
        "username": "Bret",
        "email": "Sincere@april.biz",
        "address": {
            "street": "Kulas Light",
            "suite": "Apt. 556",
            "city": "Gwenborough",
            "zipcode": "92998-3874",
            "geo": {
                "lat": "-37.3159",
                "lng": "81.1496"
            }
        },
        "phone": "1-770-736-8031 x56442",
        "website": "hildegard.org",
        "company": {
            "name": "Romaguera-Crona",
            "catchPhrase": "Multi-layered client-server neural-net",
            "bs": "harness real-time e-markets"
        }
    }
]

العمل مع طلبات النشر

* ملاحظة: يجب أن يكون لطلب النشر عبر الإنترنت التنسيق الصحيح لضمان إنشاء البيانات المطلوبة. من الممارسات الجيدة استخدام Get first للتحقق من تنسيق JSON للطلب. يمكنك استخدام أدوات مثل https://jsonformatter.curiousconcept.com/

العمل مع طلبات النشر

الخطوة 5) المقبل،

  1. انقر فوق إرسال.
  2. الحالة: 201 يجب أن يتم عرضهاyed
  3. البيانات المنشورة هي شوwing في الجسم.

العمل مع طلبات النشر

كيفية تحديد معلمات الطلبات

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

يتم إنشاء المعلمات من خلال استخدام double مجعد brackets: {{عينة}}. دعونا نلقي نظرة على مثال لاستخدام المعلمات في طلبنا السابق:

طلبات المعلمات

لنقم الآن بإنشاء طلب الحصول على معلمات.

الخطوة 1)

  1. قم بتعيين طلب HTTP الخاص بك على GET
  2. أدخل هذا الرابط: https://jsonplaceholder.typicode.com/users. استبدل الجزء الأول من الرابط بمعلمة مثل {{url}}. يجب أن يكون عنوان URL للطلب الآن {{url}}/users.
  3. انقر فوق إرسال.

يجب ألا يكون هناك أي رد لأننا لم نقم بتعيين مصدر المعلمة الخاصة بنا.

طلبات المعلمات

الخطوة 2) لاستخدام المعلمة تحتاج إلى ضبط البيئة

  1. انقر على أيقونة العين
  2. انقر فوق "تحرير" لتعيين المتغير إلى بيئة عامة يمكن استخدامها في كافة المجموعات.

طلبات المعلمات

الخطوة 3) ثابت،

  1. قم بتعيين الاسم على عنوان url وهو https://jsonplaceholder.typicode.com
  2. انقر فوق حفظ.

طلبات المعلمات

الخطوة 4) انقر فوق إغلاق إذا رأيت الشاشة التالية

طلبات المعلمات

الخطوة 5) ارجع إلى طلب الحصول على الطلب ثم انقر فوق إرسال. يجب أن تكون هناك الآن نتائج لطلبك.

طلبات المعلمات

* ملاحظة: تأكد دائمًا من أن معلماتك لها مصدر مثل متغير البيئة أو ملف البيانات لتجنب الأخطاء.

كيف تنشأ Postman اختبارات

Postman الاختبارات هي رموز JavaScript تضاف إلى الطلبات وتساعدك على التحقق من النتائج مثل الحالة الناجحة أو الفاشلة، ومقارنة النتائج المتوقعة، وما إلى ذلك. وعادة ما تبدأ بـpm.test. يمكن مقارنتها بأوامر التأكيد والتحقق المتوفرة في الأدوات الأخرى.

دعونا نفعل بعض الأساسية اختبار API استخدام Postman لطلبات المعلمات الخاصة بنا من الدرس السابق.

الخطوة 1) انتقل إلى طلب مستخدم GET الخاص بك من البرنامج التعليمي السابق.

  1. قم بالتبديل إلى علامة التبويب الاختبارات. على الجانب الأيمن توجد رموز مقتطفات.
  2. من قسم المقتطفات، اضغط على "رمز الحالة: الرمز 200".

تتم تعبئة الجزء تلقائيًا

إنشاء Postman اختبارات

الخطوة 2) الآن انقر فوق إرسال. يجب الآن أن يتم عرض نتيجة الاختبارyed.

إنشاء Postman اختبارات

الخطوة 3) ارجع إلى علامة تبويب الاختبار ودعنا نضيف اختبارًا آخر. هذه المرة سنقوم بمقارنة النتيجة المتوقعة بالنتيجة الفعلية.

من قسم المقتطفات، انقر على "نص الاستجابة: التحقق من قيمة JSON". سوف نتحقق مما إذا كانت Leanne Graham لديها معرف المستخدم 1.

إنشاء Postman اختبارات

الخطوة 4)

  1. استبدل "اسم الاختبار الخاص بك" من الكود بـ "تحقق مما إذا كان المستخدم ذو المعرف 1 هو Leanne Graham" بحيث يحدد اسم الاختبار بالضبط ما نريد اختباره.
  2. استبدل jsonData.value بـ jsonData[0].name. للحصول على المسار، قم بفحص الجسم في الحصول على النتيجة مسبقًا. نظرًا لأن Leanne Graham هو معرف المستخدم 1، فإن jsonData موجود في النتيجة الأولى التي يجب أن تبدأ بـ 0. إذا كنت تريد الحصول على النتيجة الثانية، فاستخدم jsonData[1] وما إلى ذلك للحصول على النتائج التالية.
  3. في إلى eql، أدخل "Leanne Graham"
pm.test("Check if user with id1 is Leanne Graham", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData[0].name).to.eql("Leanne Graham");
});

إنشاء Postman اختبارات

الخطوة 5) انقر فوق إرسال. من المفترض أن يكون هناك الآن نتيجتان للاختبار تم اجتيازهما لطلبك.

إنشاء Postman اختبارات

* ملاحظة: هناك أنواع مختلفة من الاختبارات التي يمكن إنشاؤها فيها Postman. حاول استكشاف الأداة ومعرفة الاختبارات التي تناسب احتياجاتك.

كيفية إنشاء المجموعات

تلعب المجموعات دورًا مهمًا في تنظيم مجموعات الاختبار. يمكن استيرادها وتصديرها مما يجعل من السهل مشاركة المجموعات بين الفريق. في هذا البرنامج التعليمي، سوف نتعلم كيفية إنشاء مجموعة وتنفيذها.

لنبدأ في إنشاء مجموعة:

الخطوة 1) انقر على الزر جديد في الزاوية اليسرى العليا من الصفحة.

إنشاء مجموعات

الخطوة 2) حدد المجموعة. يجب أن تظهر نافذة إنشاء المجموعة.

إنشاء مجموعات

الخطوة 3) أدخل اسم المجموعة ووصفها المطلوبين، ثم انقر فوق "إنشاء". يجب الآن إنشاء مجموعة.

إنشاء مجموعات

الخطوة 4) ارجع إلى طلب Get السابق. انقر فوق حفظ

إنشاء مجموعات

الخطوة 5)

  1. أختار Postman مجموعة الاختبار.
  2. انقر فوق حفظ في Postman مجموعة الاختبار

إنشاء مجموعات

الخطوة 6) Postman يجب أن تحتوي مجموعة الاختبار الآن على طلب واحد.

إنشاء مجموعات

الخطوة 7) كرر الخطوات من 4 إلى 5 لطلب النشر السابق بحيث تحتوي المجموعة الآن على طلبين.

إنشاء مجموعات

كيفية تشغيل المجموعات باستخدام Collection Runner

هناك طريقتان لتشغيل المجموعة وهما Collection Runner وNewman. لنبدأ بتنفيذ المجموعة في Collection Runner.

الخطوة 1) انقر على زر Runner الموجود في أعلى الصفحة بجوار زر Import.

تشغيل المجموعات باستخدام مشغل المجموعة

الخطوة 2) يجب أن تظهر صفحة Collection Runner كما هو موضح أدناه. فولوwing هو وصف لمختلف المجالات

تشغيل المجموعات باستخدام مشغل المجموعة

الخطوة 3) تشغيل الخاص بك Postman مجموعة الاختبار عن طريق إعداد المتابعةwing:

  • اختار Postman مجموعة الاختبار - قم بتعيين التكرارات على 3
  • اضبط التأخير على 2500 مللي ثانية
  • انقر فوق تشغيل Postman اختبار... زر

تشغيل المجموعات باستخدام مشغل المجموعة

الخطوة 4) يجب أن يتم عرض صفحة نتائج التشغيلyed بعد النقر على زر التشغيل. اعتمادًا على التأخير، يجب أن تشاهد الاختبارات أثناء تنفيذها.

  1. بمجرد انتهاء الاختبارات، يمكنك رؤية حالة الاختبار إذا تم اجتيازه أو فشله والنتائج لكل تكرار.
  2. ترى حالة المرور للحصول على الطلبات
  3. وبما أنه لم يكن لدينا أي اختبارات للنشر، فمن المفترض أن تكون هناك رسالة مفادها أن الطلب لم يكن لديه أي اختبارات.

تشغيل المجموعات باستخدام مشغل المجموعة

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

كيفية تشغيل المجموعات باستخدام نيومان

هناك طريقة أخرى لتشغيل المجموعة وهي عبر نيومان. الاختلافات الرئيسية بين نيومان وCollection Runner هي ما يليwing:

  1. نيومان هو الوظيفة الإضافية ل Postman. ستحتاج إلى تثبيته بشكل منفصل عن التطبيق الأصلي.
  2. يستخدم نيومان سطر الأوامر بينما يحتوي Collection Runner على واجهة المستخدم الرسومية.
  3. يمكن استخدام نيومان للتكامل المستمر.

لتثبيت نيومان وتشغيل مجموعتنا منه، قم بما يليwing:

الخطوة 1) قم بتثبيت Nodejs باستخدام هذا الرابط: http://nodejs.org/download/

الخطوة 2) افتح سطر الأوامر وأدخل

 npm install -g newman

يجب الآن تثبيت نيومان على جهاز الكمبيوتر الخاص بك.

تشغيل المجموعات باستخدام نيومان

الخطوة 3) بمجرد تثبيت نيومان، دعونا نعود إلى موقعنا Postman مساحة العمل.في المجموعات box، انقر على النقاط الثلاث. يجب أن تظهر الخيارات الآن. حدد تصدير.

تشغيل المجموعات باستخدام نيومان

الخطوة 4) اختر تصدير المجموعة كمجموعة v2.1 (مستحسن) ثم انقر فوق تصدير.

تشغيل المجموعات باستخدام نيومان

الخطوة 5) حدد الموقع المطلوب ثم انقر فوق حفظ. يُنصح بإنشاء مجلد خاص بك Postman الاختبارات. يجب الآن تصدير المجموعة إلى الدليل المحلي الذي اخترته.

الخطوة 6) سنحتاج أيضًا إلى تصدير بيئتنا. انقر على أيقونة العين بجانب القائمة المنسدلة للبيئة في Global، وحدد Download as JSON. حدد الموقع المطلوب ثم انقر فوق حفظ. من المستحسن أن تكون البيئة في نفس المجلد الذي توجد فيه مجموعتك.

تشغيل المجموعات باستخدام نيومان

الخطوة 7) يجب الآن تصدير البيئة إلى نفس الدليل المحلي مثل Collection.

الخطوة 8) عد الآن إلى سطر الأوامر وقم بتغيير الدليل إلى المكان الذي قمت بحفظ المجموعة والبيئة فيه.

 cd C:\Users\Asus\Desktop\Postman Tutorial

الخطوة 9) قم بتشغيل مجموعتك باستخدام هذا الأمر:

 newman run PostmanTestCollection.postman_collection.json -e Testing.postman_globals.json

يجب أن تظهر نتائج التشغيل الآن كما هو موضح أدناه.

تشغيل المجموعات باستخدام نيومان

للدليل إشارة إلى بعض رموز نيومان الأساسية للتنفيذ:

  1. تشغيل مجموعة فقط. يمكن استخدام هذا في حالة عدم وجود تبعية لملف بيانات البيئة أو الاختبار.
  2. newman run <collection name>
  3. تشغيل المجموعة والبيئة. المؤشر -e مخصص للبيئة.
  4. newman run <collection name> -e <environment name>
  5. قم بتشغيل مجموعة بالرقم المطلوب. من التكرارات.
  6. newman run <collection name> -n <no.of iterations>
  7. تشغيل مع ملف البيانات.
  8. newman run <collection name> --data <file name>  -n <no.of iterations> -e <environment name>
  9. ضبط وقت التأخير. وهذا أمر مهم لأن الاختبارات قد تفشل إذا تم تشغيلها دون تأخير بسبب بدء الطلبات دون إكمال الطلب السابق للمعالجة على خادم نقطة النهاية.
newman run <collection name> -d <delay time>

الأهداف و Postman دليل أسئلة المقابلة سوف يساعدك على اجتياز المقابلة ومساعدتك في الحصول على وظيفة أحلامك لاختبار البرمجيات.

نبذة عامة

  • اختبار API باستخدام Postman: Postman هو تطبيق لاختبار واجهات برمجة التطبيقات. Postman هي إحدى الأدوات الأكثر شيوعًا المستخدمة في اختبار واجهة برمجة التطبيقات (API) عن طريق إرسال الطلبات إلى خادم الويب والحصول على الاستجابة مرة أخرى
  • تعد إمكانية الوصول واستخدام المجموعات والتعاون والتكامل المستمر من بين الميزات الأساسية التي يجب التعلم فيها Postman
  • يوصى بإنشاء حساب في Postman، لذا فإن مجموعاتك متاحة على الإنترنت
  • يمكنك تحديد معلمات الطلب في Postman
  • يمكنك إنشاء اختبارات للتحقق من أ postman طلب
  • يمكن تشغيل المجموعات باستخدام Newman أو Collection Runner