معرفی 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، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.