اجرای تست‌های API با Postman Monitors

با Postman Monitors می‌توانید سلامت و عملکرد APIهای خود را به صورت مداوم بررسی کنید. Monitor در زمان اجرا، requestها و testهای یک collection را اجرا می‌کند و اگر test شکست بخورد، error رخ دهد یا timeout شود، نتیجه ثبت و اطلاع‌رسانی می‌شود.

می‌توانید monitor را طبق schedule اجرا کنید یا کاری کنید فقط با Postman CLI trigger شود. همه نتایج در بخش monitor results قابل مشاهده هستند.

مانیتور کردن یک endpoint #

برای monitor کردن یک API endpoint، collectionی بسازید که شامل یک یا چند request برای همان endpoint باشد. برای responseها test بنویسید تا status code، body، header یا زمان پاسخ بررسی شود.

می‌توانید چند variation از request را هم پوشش دهید؛ مثلاً query parameter، header یا request body متفاوت. این کار نشان می‌دهد endpoint در شرایط مختلف درست رفتار می‌کند یا نه.

مانیتور کردن کل API #

برای monitor کردن یک API کامل، collectionی بسازید که endpointها و workflowهای مهم را پوشش دهد. برای مقدارهای مشترک مثل base URL از environment variable استفاده کنید.

همچنین می‌توانید داده را بین requestها منتقل کنید تا استفاده واقعی‌تر از API شبیه‌سازی شود و مشخص شود بخش‌های مختلف API با هم درست کار می‌کنند.

اجرای testها در monitor #

در APIهایی که requestها به هم وابسته‌اند، می‌توانید بخشی از response را به variable تبدیل کنید و در requestهای بعدی استفاده کنید. برای داده‌های پیچیده مثل object یا array، آن را با JSON.stringify() ذخیره و با JSON.parse() دوباره بخوانید.

// Set the value
pm.environment.set("data", JSON.stringify({ id: 123 }));

// Get the value
const data = JSON.parse(pm.environment.get("data"));

بررسی HTTP response code #

در post-response script می‌توانید status code را validate کنید:

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

بررسی latency #

برای کنترل زمان پاسخ، testی بنویسید که response time از حد قابل قبول بیشتر نشود:

pm.test("Response time is acceptable", function () {
  // responseTime is in milliseconds
  pm.expect(pm.response.responseTime).to.be.below(1000);
});

منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.