تنظیم دایرکتوری کاری در Postman

وقتی در بدنه درخواست از فایل استفاده می‌کنید، مثلا فایل را به صورت form-data یا binary می‌فرستید، Postman مسیر آن فایل را همراه مجموعه ذخیره می‌کند. این مسیر نسبت به دایرکتوری کاری Postman محاسبه می‌شود.

دایرکتوری کاری پیش‌فرض کجاست؟ #

در macOS و Linux مسیر پیش‌فرض معمولا ~/Postman/files است. در Windows می‌توانید آن را در %userprofile%\Postman\files ببینید؛ در PowerShell هم معمولا مسیر ~/Postman/files استفاده می‌شود.

چرا این مسیر مهم است؟ #

اگر یک درخواست را با تیم خود به اشتراک بگذارید، Postman فقط مسیر فایل را در مجموعه نگه می‌دارد. بنابراین اگر اعضای تیم فایل را در همان مسیر کاری نداشته باشند، درخواست برای آن‌ها درست اجرا نمی‌شود.

تغییر دایرکتوری کاری #

برای تغییر مسیر، از تنظیمات برنامه وارد بخش Working directory شوید و گزینه Choose را انتخاب کنید. سپس پوشه‌ای را انتخاب کنید که می‌خواهید Postman برای فایل‌های درخواست‌ها از آن استفاده کند.

کار با Postman Web #

در نسخه وب Postman نمی‌توانید دایرکتوری کاری را مستقیم تغییر دهید. وقتی در نسخه وب فایلی را به درخواست اضافه می‌کنید، Postman یک پوشه با نام تصادفی داخل ~/Postman/files می‌سازد و یک کپی از فایل را آنجا قرار می‌دهد.

اگر هم‌زمان از برنامه دسکتاپ و نسخه وب استفاده می‌کنید، مسیر فایل‌ها را با دقت هماهنگ کنید. برای مثال اگر فایلی را در برنامه دسکتاپ دارید و می‌خواهید در نسخه وب هم استفاده شود، آن را به ~/Postman/files منتقل کنید. اگر فایل را از نسخه وب اضافه کرده‌اید و می‌خواهید در برنامه دسکتاپ هم قابل استفاده باشد، پوشه ساخته‌شده در ~/Postman/files را به دایرکتوری کاری برنامه دسکتاپ منتقل کنید.

روش بهتر برای کار تیمی #

برای جلوگیری از جابه‌جایی دستی فایل‌ها، می‌توانید فایل‌های تست را در تیم Postman آپلود کنید. در این حالت اعضای تیم بدون اینکه فایل را جداگانه روی سیستم خود کپی کنند، می‌توانند درخواست مشترک را اجرا کنند.

استفاده در Newman #

اگر مجموعه را با Newman اجرا می‌کنید، فایل‌هایی که در درخواست‌ها استفاده می‌شوند باید در مسیر دایرکتوری کاری ذخیره شده در مجموعه در دسترس باشند.

هشدار امنیتی #

گزینه Read files outside working directory اجازه می‌دهد مجموعه‌ها به فایل‌های خارج از دایرکتوری کاری هم دسترسی داشته باشند. این گزینه را فقط وقتی فعال کنید که به مجموعه و منبع آن اعتماد دارید، چون می‌تواند به فایل‌های بیشتری از سیستم شما دسترسی بدهد.

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