ملخص متغيرات جسم الرسالة في Postman

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

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

فهم متغيرات جسم طلب POST في Postman

متغيرات جسم POST هي عناصر مكانية ديناميكية تُستخدم داخل جسم الطلب في طلب POST في Postman. تتيح لك استبدال القيم الثابتة بمتغيرات، مما يجعل اختبارات واجهة برمجة التطبيقات أكثر مرونة وإعادة استخدام وفعالية.

أنواع متغيرات جسم POST

هناك عدة أنواع من المتغيرات التي يمكنك استخدامها في Postman:

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

استخدام متغيرات جسم POST

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

{
    "username": "{{username}}"
}

بدلاً من ذلك، يمكنك استخدام دالة pm.variables.get() لاسترجاع قيمة متغير برمجيًا وإدراجها في جسم الطلب.

أمثلة برمجية للتلاعب بمتغيرات جسم طلب POST في Postman

تتيح لك قدرات البرمجة في Postman التلاعب بمتغيرات جسم طلب POST ديناميكيًا أثناء وقت التشغيل. إليك بعض الأمثلة الشائعة:

مثال 1 - تعيين قيمة متغير:

pm.variables.set("myVariable", "Hello, World!");

يقوم هذا النص البرمجي بتعيين قيمة myVariable إلى "Hello, World!". يمكنك بعد ذلك استخدام هذا المتغير في جسم الطلب الخاص بك.

مثال 2 - استرجاع قيمة متغير:

var myVariableValue = pm.variables.get("myVariable");
console.log(myVariableValue); // الخرج: Hello, World!

يقوم هذا النص البرمجي باسترجاع قيمة myVariable وتسجيلها في وحدة التحكم.

مثال 3 - دمج المتغيرات:

var firstName = "John";
var lastName = "Doe";
pm.variables.set("fullName", firstName + " " + lastName);

يقوم هذا النص البرمجي بدمج متغيرات firstName و lastName وتعيين النتيجة إلى المتغير fullName.

مثال 4 - تعديل بيانات JSON:

var jsonData = pm.request.body.raw();
jsonData.name = "اسم محدث";
pm.request.body.raw = jsonData;

يقوم هذا النص البرمجي باسترجاع بيانات JSON من جسم الطلب، وتعديل خاصية name، وتعيين البيانات المعدلة مرة أخرى إلى جسم الطلب.

مثال 5 - منطق شرطي:

var age = pm.variables.get("age");
if (age >= 18) {
    pm.variables.set("isAdult", true);
} else {
    pm.variables.set("isAdult", false);
}

يقوم هذا النص البرمجي بالتحقق من قيمة المتغير age ويُعين المتغير isAdult وفقًا لذلك.

مثال 6 - استخدام متغيرات البيئة:

var baseUrl = pm.environment.get("baseUrl");
pm.variables.set("apiUrl", baseUrl + "/api");

يقوم هذا النص البرمجي باسترجاع baseUrl من البيئة وبناء apiUrl باستخدامه.

Apidog - بديل حديث وسلس لـ Postman

هناك العديد من البدائل لـ Postman التي يمكن أن تؤدي المهمة. إذا كنت مطورًا تبحث عن أداة من هذا النوع.

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

يمكنك أيضًا التلاعب بمتغير جسم طلب POST مع Apidog، لذا تعال وانظر كيف يمكنك القيام بذلك.

استغلال نصوص ما بعد المعالجة في Apidog

يُمكّن Apidog المستخدمين من تخصيص منطق ما بعد المعالجة من خلال تنفيذ نصوص مخصصة. تسمح هذه المرونة بالتلاعب بالبيانات، والتحقق من صحتها، وعمليات أخرى بعد الطلب. تتوفر مجموعة واسعة من المعالجات المسبقة التعريف، بما في ذلك آليات العنصر والنصوص العامة.

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

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

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

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

الخاتمة

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

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