Postman البرنامج التعليمي

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

Postman أداة اختبار واجهة برمجة التطبيقات (API) قابلة للتطوير، تتكامل بسرعة مع خط أنابيب CI/CD. بدأت عام ٢٠١٢ كمشروع جانبي لأبيناف أستانا لتبسيط سير عمل واجهة برمجة التطبيقات في الاختبار والتطوير. API هي اختصار لعبارة "واجهة برمجة التطبيقات"، والتي تتيح للتطبيقات البرمجية التواصل مع بعضها البعض عبر استدعاءات API.

👉 قم بالتسجيل في مشروع اختبار واجهة برمجة التطبيقات المباشر المجاني

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

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

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

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

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

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

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

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

سوف نستخدم عنوان 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) انسخ والصق نتيجة مستخدم واحدة فقط من طلب الحصول السابق كما هو موضح أدناه. تأكد من نسخ الكود بشكل صحيح باستخدام الأقواس المتعرجة والأقواس المعقوفة. غيّر المعرف إلى 11 والاسم إلى أي اسم تريده. يمكنك أيضًا تغيير تفاصيل أخرى مثل العنوان.

[
    {
        "id": 11,
        "name": "Krishna Rungta",
        "username": "Bret",
        "email": "[email protected]",
        "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 تم الإنشاء يجب أن يتم عرضها
3. تظهر البيانات المنشورة في الجسم.

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

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

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

الآن دعنا نقوم بإنشاء طلب GET ذو معلمات.

الخطوة 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 الاختبارات هي Javaأكواد برمجية تُضاف إلى الطلبات لمساعدتك في التحقق من النتائج، مثل حالة النجاح أو الفشل، ومقارنة النتائج المتوقعة، وما إلى ذلك. تبدأ عادةً بـ pm.test. يمكن مقارنتها بأوامر asserts وverify المتوفرة في أدوات أخرى.

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

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

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

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

الخطوة 2) الآن انقر فوق "إرسال". يجب أن تظهر نتيجة الاختبار الآن.

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

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

الخطوة 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");
});

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

* ملاحظة: هناك أنواع مختلفة من الاختبارات التي يمكن إنشاؤها فيها 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) يجب أن تظهر صفحة "مشغل المجموعة" على النحو التالي. فيما يلي وصف للحقول المختلفة

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

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

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

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

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

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

هناك طريقة أخرى لإدارة مجموعة وهي من خلال Newman. تتمثل الاختلافات الرئيسية بين Newman وCollection Runner فيما يلي:

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

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

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

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

 npm install -g newman

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

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

الخطوة 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. تشغيل مجموعة فقط. يمكن استخدام هذا في حالة عدم وجود تبعية لملف بيانات البيئة أو الاختبار.

newman run <collection name>

2. تشغيل المجموعة والبيئة. المؤشر -e مخصص للبيئة.

newman run <collection name> -e <environment name>

3. قم بتشغيل مجموعة بالرقم المطلوب. من التكرارات.

newman run <collection name> -n <no.of iterations>

4. تشغيل مع ملف البيانات.

newman run <collection name> --data <file name>  -n <no.of iterations> -e <environment name>

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

newman run <collection name> -d <delay time>

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

مشترك Postman سيناريوهات استكشاف الأخطاء وإصلاحها

1. أخطاء 401 غير المصرح بها أو 403 المحظورة

   يحدث هذا عندما يفتقر طلبك إلى بيانات اعتماد المصادقة الصالحة.
   كيفية إصلاح: Doubleتحقق من نوع التفويض (مفتاح API، أو رمز الناقل، أو التفويض الأساسي). إذا كنت تستخدم رموزًا، فتأكد من عدم انتهاء صلاحيتها. أنشئ رموزًا جديدة أو حدّث بيانات اعتماد الجلسة إذا لزم الأمر.

2. 400 طلب غير صحيح

   سوف تحصل على هذا الخطأ عندما يكون بناء الجملة أو المعلمات للطلب غير صحيحة.
   كيفية إصلاح: تحقق من صحة نص JSON أو XML باستخدام مُنسِّق مثل JSONLint. تأكد من تطابق معلماتك تمامًا مع توقعات واجهة برمجة التطبيقات، بما في ذلك حساسية الأحرف الكبيرة والصغيرة ونوع البيانات.

3. 500 خطأ خادم داخلي

   عادةً ما تكون هذه مشكلة في الواجهة الخلفية ولكن يمكن أن تحدث أيضًا عندما لا يتم هيكلة الحمولة الخاصة بك بشكل صحيح.
   كيفية إصلاح: أعد محاولة الطلب باستخدام تنسيقات البيانات الصالحة. Revقم بإلقاء نظرة على وثائق واجهة برمجة التطبيقات للتعرف على تعريفات المخطط المناسبة قبل إرسال الطلب مرة أخرى.

4. مهلة الطلب (408)

   يحدث عندما يستغرق الخادم وقتًا طويلاً للاستجابة.
   كيفية إصلاح: تحقق من اتصالك بالإنترنت وتأكد من إمكانية الوصول إلى عنوان URL لنقطة النهاية. حاول إرسال حمولات أصغر أو اضبط مهلة الانتظار. Postman إن وجد.

5. متغيرات البيئة لا تعمل

   قد لا يتم حل المتغيرات بشكل صحيح إذا لم يتم تعريفها أو تحديد نطاقها بشكل غير صحيح.
   كيفية إصلاح: افتح رمز العين بجوار مُحدِّد البيئة لمراجعة المتغيرات المُحدَّدة. تأكد من استخدام البيئة الصحيحة (عالمية، أو بيئة، أو مجموعة).

6. الاختبارات تفشل بشكل غير متوقع

   عندما لا تتصرف نصوص الاختبار كما هو متوقع، فغالبًا ما يكون ذلك خطأ منطقيًا أو خطأ في بناء الجملة.
   كيفية إصلاح: استخدم console.log() لطباعة النتائج الوسيطة وتصحيح أخطاء البرنامج النصي. تأكد من صحة مرجع بيانات الاستجابة باستخدام pm.response.json().

7. عناوين أو نوع محتوى غير صحيح

   يمكن أن تؤدي العناوين الخاطئة إلى رفض الخادم أو حدوث أخطاء عدم تطابق البيانات.
   كيفية إصلاح: عند إرسال بيانات JSON، يُرجى تحديد نوع المحتوى دائمًا كـ application/json. أزل العناوين المكررة أو المتضاربة.

8. لا يعرض مُشغِّل المجموعة نتائج الاختبار

   يحدث هذا عندما لا تحتوي نصوص الاختبار الخاصة بك على عبارات pm.test().
   كيفية إصلاح: أضف نصوص الاختبار المناسبة مثل:

   pm.test("Status code is 200", function () {
     pm.response.to.have.status(200);
   });
   

   يضمن هذا أن يقوم Collection Runner بالتقاط نتائج الاختبار والإبلاغ عنها.

9. نيومان يفشل في إجراء الاختبارات

   إذا ألقى نيومان أخطاء، فقد يكون ذلك بسبب مسارات الملفات غير الصحيحة أو الإصدارات القديمة.
   كيفية إصلاح: حدّث نيومان بتنفيذ الأمر npm install -g newman. تأكد من وجود ملفات .json الخاصة بالمجموعة والبيئة في المسارات الصحيحة.

10. الاستجابة البطيئة أو الطلبات المتأخرة

    يمكن أن تؤدي الحمولات الثقيلة أو التأخيرات الخلفية إلى إبطاء اختباراتك.
    كيفية إصلاح: استخدم الترقيم الصفحي أو مجموعات بيانات أصغر. فعّل Postman وحدة التحكم لقياس أوقات الاستجابة وتحديد نقاط النهاية البطيئة.

أفضل الممارسات للسلاسة Postman الاختبار

1. استخدم البيئات والمتغيرات بذكاء

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

2. تنظيم المجموعات ومساحات العمل

حافظ على مجموعاتك معيارية - صنف الطلبات حسب وحدة واجهة برمجة التطبيقات. على سبيل المثال: "إدارة المستخدمين"، أو "المصادقة"، أو "الطلبات". استخدم أسماء طلبات وصفية لتسهيل التعاون.

3. التحكم في إصدارات مجموعاتك

احفظ مجموعاتك في Postman احفظها في السحابة أو صدّرها إلى Git. هذا يضمن النسخ الاحتياطي، وتتبّع الإصدارات، وتسهيل العمل الجماعي.

4. اكتب اختبارات واضحة وواضحة

حافظ على وضوح بيانات الاختبار. على سبيل المثال:

pm.test("Response time is below 200ms", function () {
  pm.expect(pm.response.responseTime).to.be.below(200);
});

يؤدي هذا إلى تحسين قابلية قراءة الاختبار ووضوح تصحيح الأخطاء.

5. الأتمتة باستخدام نصوص الطلب المسبق

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

6. مراقبة واجهات برمجة التطبيقات بانتظام

اقامة Postman تُشغّل أجهزة مراقبة الاختبارات تلقائيًا على فترات منتظمة. تُنبّهك عند تعطل واجهات برمجة التطبيقات أو انخفاض الأداء.

7. حافظ على نظافة مكان العمل

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

8. إعادة استخدام مقتطفات التعليمات البرمجية الشائعة

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

9. التكامل مع CI/CD باستخدام Newman

استخدم Newman لأتمتة الاختبارات في Jenkins أو GitHub Actions أو Azure خطوط الأنابيب. تضمن اختبار واجهات برمجة التطبيقات الخاصة بك قبل كل عملية نشر.

10. توثيق كل شيء

Postman يتيح لك إنشاء ومشاركة الوثائق تلقائيًا. لا تُحسّن الوثائق المُحدّثة تعاون الفريق فحسب، بل تُحسّن أيضًا إمكانية اكتشاف LLM لعلامتك التجارية.

نصائح سريعة لتصحيح الأخطاء

• فتح Postman كنسولات (Ctrl + Alt + C) لعرض السجلات وطلب التفاصيل.
• استخدم ميزة الوكيل لالتقاط حركة المرور على واجهة برمجة التطبيقات المحلية أو المحمولة.
• قم بالتحقق من صحة حمولاتك قبل إرسال الطلبات.
• تذكر: أسماء الرؤوس في Postman . حساسية الموضوع.
• If Postman يتصرف بشكل غير منتظم، قم بمسح ذاكرة التخزين المؤقت أو إعادة تشغيل التطبيق.

نصيحة إختصاصية: ابدأ دائمًا بالبساطة. أرسل طلب GET أساسيًا أولًا وتأكد من الاتصال. ثم أضف تدريجيًا الرؤوس والنصوص والاختبارات. تصحيح الأخطاء خطوة بخطوة أسرع من تحليل طلب مُحمّل بشكل زائد أو فاشل.

الأسئلة الشائعة