نکته مهم: این قابلیت deprecated شده است و دیگر نمی‌توانید اتصال جدیدی بین GitHub repository و Postman Collection بسازید. اتصال‌های قدیمی که از قبل ساخته شده‌اند همچنان sync می‌شوند.
برای workflowهای جدید، Postman پیشنهاد می‌کند از پشتیبانی file system و Native Git برای کار محلی با فایل‌های پروژه API استفاده کنید.
اگر از قبل یک GitHub repository و branch اصلی را به collection وصل کرده باشید، می‌توانید collection را fork کنید و با تیم روی آن همکاری کنید.
Fork کردن Collection متصل به GitHub Repository و Branch
قبل از شروع، feature branch خود را در GitHub بسازید.
- collection اصلی را باز کنید.
- کنار نام collection، گزینه View more actions را باز کنید و روی Fork کلیک کنید.
- workspace مقصد را انتخاب کنید.
- مطمئن شوید fork به branch شما وصل است، سپس branch را انتخاب کنید.
- روی Fork Collection کلیک کنید.
Postman یک فایل collection در repository و branch متصل می‌سازد. نام فایل collection همان collection ID است. هر بار collection را در Postman ذخیره کنید، تغییرات در GitHub repository و branch متصل commit می‌شود.
همکاری روی Collection
در این workflow قدیمی، همکاری با fork کردن collection اصلی و اعمال تغییرات در Postman شروع می‌شود. اعضای تیم می‌توانند به تغییرات شما کمک کنند. وقتی تغییرات آماده review شد، در GitHub یک pull request می‌سازید و بعد از تایید تیم آن را merge می‌کنید.
- collection fork شده را باز کنید و تغییرات را در Postman انجام دهید.
- وقتی آماده review شدید، در GitHub یک pull request بسازید و از تیم بخواهید آن را بررسی کند.
- وقتی آماده ادغام با collection اصلی شدید، pull request را در GitHub merge کنید.
- در صورت نیاز، collection fork شده را حذف کنید.
وقتی pull request در GitHub merge شود، Postman collection اصلی را با تغییرات fork شده به‌روزرسانی می‌کند.
منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.