معرفی Application Inventory در Postman

Application Inventory در Postman به شما دید بهتری از برنامه‌هایی می‌دهد که می‌سازید، APIهای خارجی که برنامه به آن‌ها وابسته است، و test coverage مربوط به این وابستگی‌ها. این قابلیت در پلن‌های Solo، Team و Enterprise در دسترس است.

Application Inventory با test suiteهای UI موجود شما یکپارچه می‌شود، تعاملات API را هنگام اجرای testها capture می‌کند، آن‌ها را با Postman Collectionها validate می‌کند و dependencyها را کشف می‌کند. برای Playwright، Postman یک network capture plugin اختصاصی ارائه می‌دهد.

چه تیم‌هایی از Application Inventory سود می‌برند؟ #

• تیم‌های engineering که frontend یا service applicationهایی را نگه‌داری می‌کنند که به چند API داخلی وابسته‌اند.
• تیم‌های platform یا quality که به یک نمای مرکزی از dependencyهای application-to-API و test coverage نیاز دارند.
• تیم‌هایی که UI test suite دارند، معمولاً با Playwright، اما راه ساختاریافته‌ای برای validate کردن لایه API ندارند.

Application Inventory چه مسئله‌ای را حل می‌کند؟ #

رابطه بین application و API معمولاً مستند نیست یا سریع قدیمی می‌شود. UI testها ترافیک واقعی تولید می‌کنند، اما این ترافیک بیشتر فقط در trace و log دیده می‌شود. Application Inventory این ترافیک را به evidence قابل استفاده برای validation، dependency discovery و traceability تبدیل می‌کند.

این قابلیت کمک می‌کند این نوع مشکل‌ها را پیدا کنید:

• False positives: UI درست به نظر می‌رسد، اما endpoint اشتباه صدا زده شده یا payload درست نبوده است.
• Silent degradation: backend error به fallback عمومی در UI تبدیل شده و test همچنان pass شده است.
• Contract drift: تغییر schema، header یا content-type که فوراً UI را خراب نمی‌کند، پنهان می‌ماند.
• Poor diagnostics: بدون capture ساختاریافته، failureها به حدس و گمان تبدیل می‌شوند.

workflow اصلی Application Inventory #

دستور postman app test تست UI موجود برنامه را wrap می‌کند، ترافیک network را مشاهده می‌کند، API callهای دیده‌شده را با Postman Collectionها validate می‌کند و نتیجه‌ها و dependencyهای کشف‌شده را به Application Inventory می‌فرستد.

این pipeline چهار مرحله دارد:

1. Capture: Playwright plugin به browser context وصل می‌شود و request/response eventها را stream می‌کند.
2. Ingest: دستور postman app test network callهای captureشده را ingest می‌کند.
3. Analyze: CLI callها را با collection requestها match می‌کند و برای موارد matchشده، assertionهای pm.test را روی responseهای واقعی اجرا می‌کند.
4. Report: نتیجه‌ها در terminal نمایش داده می‌شوند و به Application Inventory push می‌شوند.

کاوش داده‌های application #

بعد از push شدن نتیجه تست‌ها، می‌توانید از viewهای مختلف استفاده کنید:

• Dependencies: APIهایی که application به آن‌ها وابسته است را ببینید.
• Tests: رفتار تست‌ها، trendهای pass/fail و API activity مربوط به هر test را بررسی کنید.
• CI/CD Runs: runهای جداگانه را بررسی و failureها را تحلیل کنید.
• Dependency Graph: رابطه dependencyها را به صورت graph ببینید.

Agent Mode integration #

Application Inventory با Agent Mode هم یکپارچه است. از صفحه Application Inventory می‌توانید با زبان طبیعی از agent بخواهید آخرین runهای یک پروژه را خلاصه کند و نتیجه قابل خواندن برای انسان برگرداند.

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