[دليل] نصوص طلبات POST في Postman

Postman هي أداة مشهورة لتطوير واختبار واجهات برمجة التطبيقات (API). تسهل عملية إرسال الطلبات وتحليل الاستجابات، مما يسمح للمطورين ببناء وتصحيح واجهات برمجة التطبيقات بكفاءة. يوسع برمجة Postman هذه الوظائف من خلال تمكين أتمتة المهام المتكررة ضمن عملية الاختبار.

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

ما هي نصوص طلبات ما بعد Postman

نصوص الطلبات بعد Postman هي في الأساس برامج صغيرة مكتوبة بجافا سكريبت تُنفذ بعد أن يرسل Postman طلبًا ويتلقى استجابة من واجهة برمجة التطبيقات.

إنها الأداة المفضلة للمطورين الذين يعملون مع واجهات برمجة التطبيقات (واجهة برمجة التطبيقات). تبسط إرسال الطلبات، وتحليل الاستجابات، وفي النهاية، بناء وتصحيح واجهات برمجة التطبيقات.

الوظائف الأساسية لنصوص طلبات Postman بعد

التحقق من الاستجابة

التحقق من رمز الحالة: يمكن للنصوص التحقق مما إذا كانت واجهة برمجة التطبيقات تستجيب برمز الحالة المتوقع (مثل 200 للنجاح). هذا يضمن أن واجهة برمجة التطبيقات تعمل كما هو مقصود.

تحقق من البيانات: يمكنك كتابة تحقق من صحة محتوى جسم الاستجابة. يمكن للنصوص التحقق من قيم محددة، وهياكل البيانات (مثل كائنات JSON بمفاتيح معينة)، أو التأكد من غياب بيانات غير متوقعة.

تح Manipulating البيانات

تحويل بيانات الاستجابة: يمكن للنصوص معالجة البيانات المستلمة في الاستجابة. قد يتضمن ذلك تنسيق التواريخ، أو تحويل الوحدات، أو استخراج أجزاء معينة من المعلومات لاستخدامها لاحقًا.

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

التكامل مع الأدوات الخارجية

إرسال الإشعارات: يمكن للنصوص إطلاق إشعارات بناءً على نتائج الاختبار. تخيل إرسال رسالة إلى Slack إذا فشل اختبار API حرج.

تسجيل النتائج: يسمح البرمجة بتسجيل نتائج الاختبار في قواعد بيانات خارجية لمزيد من التحليل أو الأغراض الإبلاغية.

بيئة البرمجة والكائنات

تنفيذ جافا سكريبت: يوفر Postman بيئة "Sandbox" حيث تعمل نصوصك بأمان.

الوصول إلى بيانات الطلب والاستجابة: يوفر كائن pm الوصول إلى خصائص متنوعة، مع التركيز على pm.response للتفاعل مع بيانات الاستجابة (الجسم، الرؤوس، إلخ).

استخدامات شائعة لنصوص طلبات Postman بعد

التحقق الشامل من الاستجابة

التحقق من رموز الحالة: يمكن للنصوص التأكد من أن واجهة برمجة التطبيقات تستجيب برمز الحالة المتوقع للنجاح (200)، الأخطاء (400، 404)، أو رموز ذات صلة أخرى.

تحقق من بيانات مفصلة: تجاوز الفحص البسيط. يمكن للنصوص التحقق من هياكل بيانات معقدة ضمن جسم الاستجابة. يمكنك التحقق من وجود أو غياب مفاتيح معينة في كائن JSON، والتحقق من تنسيق البيانات (مثل التواريخ، عناوين البريد الإلكتروني)، أو التأكد من وجود قيم معينة ضمن هياكل متداخلة.

استخراج البيانات لاستخدامها لاحقًا: يمكن للنصوص استخراج معلومات قيمة من جسم الاستجابة. يمكن بعد ذلك استخدام هذه البيانات في الطلبات اللاحقة، أو تخزينها للتحليل لاحقًا، أو تمريرها إلى أدوات أخرى لمزيد من المعالجة.

التح Manipulating البيانات المتقدمة

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

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

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

التكامل مع الأدوات الخارجية لاختبار محسّن

إرسال الإشعارات: تخيل تلقي إشعار فوري على Slack في كل مرة يفشل فيها اختبار API حرج. يمكن للنصوص تشغيل إشعارات بناءً على نتائج الاختبار، مما يبقي فريقك على اطلاع حول القضايا المحتملة.

تسجيل نتائج الاختبارات: يمكن استخدام النصوص لتسجيل نتائج الاختبار التفصيلية في قواعد بيانات خارجية. يسمح ذلك بتقارير شاملة، وتحليل تاريخي لأداء الاختبارات، وتحديد الاتجاهات بمرور الوقت.

التكامل مع أطر الاختبار: يمكن للنصوص ربط Postman بأطر الاختبار الخارجية مثل Jest أو Mocha. يتيح لك ذلك الاستفادة من أدوات الاختبار الموجودة ضمن سير عمل Postman الخاص بك للحصول على نهج أكثر شمولية للاختبار.

أمثلة على نصوص طلبات Postman بعد

الوصول إلى رمز حالة الاستجابة وبيانات الجسم

pm.test("رمز الحالة هو 200", function () {
  pm.response.to.have.status(200);
});

console.log(pm.response.json());

يقوم هذا النص بأداء عمليتين:

• يستخدم pm.test للتحقق من أن رمز حالة الاستجابة هو 200 (مما يدل على النجاح).
• يستخدم pm.response.json() لطباعة محتوى جسم الاستجابة بالكامل إلى وحدة التحكم لفحصه.

إنشاء التأكيدات باستخدام pm.test

تسمح لك وظيفة pm.test من Postman بكتابة تأكيدات أكثر قوة حول بيانات الاستجابة. إليك بعض الأمثلة:

التحقق من القيم المحددة

pm.test("اسم موجود في الاستجابة", function () {
  pm.expect(pm.response.json().name).to.equal("جون دو");
});

التحقق من هيكل البيانات

pm.test("الاستجابة تحتوي على الهيكل المتوقع", function () {
  pm.expect(pm.response.json()).to.have.property("id");
  pm.expect(pm.response.json()).to.have.property("name");
});

Apidog - أداة تطوير واجهات برمجة التطبيقات الشاملة

Apidog هي أداة شاملة لواجهة برمجة التطبيقات توفر للمستخدمين وظائف كاملة لدورة حياة واجهة برمجة التطبيقات بأكملها. لم يعد عليك تنزيل تطبيقات إضافية!

تطبيق نصوص المعالجة اللاحقة الخاصة بك باستخدام Apidog

مع Apidog، يمكنك تنفيذ المعالجة اللاحقة بالطريقة التي ترغب بها.

يمكنك الاختيار من بين مجموعة متنوعة من المعالجات اللاحقة، مثل التأكيدات، المخصصة، وحتى النصوص العامة.

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

يمتلك Apidog ميزة اختبار فريدة تُدعى سيناريوهات الاختبار.

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

واجهات برمجة التطبيقات المثالية مع تقارير دقيقة ومفصلة

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

الخاتمة

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

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