برای آماده‌سازی APIهای عمومی، می‌توانید یک workspace داخلی داشته باشید تا تیم شما تغییرات بعدی را در آن پیش‌نویس، بررسی و هماهنگ کند. سپس وقتی نسخه بعدی API آماده شد، تغییرات را از طریق pull request به workspace عمومی منتقل کنید.
اگر ترجیح می‌دهید همه کارها را فقط در یک workspace انجام دهید، می‌توانید این مرحله را رد کنید و مستقیم سراغ انتشار APIهای عمومی بروید. اما برای تیم‌هایی که چند نفر روی API کار می‌کنند، workspace داخلی معمولا کنترل و همکاری بهتری می‌دهد.
workspace داخلی بسازید
بسته به روند کاری تیم، می‌توانید workspace خصوصی یا تیمی بسازید. اگر فقط افراد دعوت‌شده باید دسترسی داشته باشند، private workspace مناسب است. اگر می‌خواهید اعضای تیم بتوانند راحت‌تر همکاری کنند، team workspace انتخاب بهتری است.
- در header پست‌من، workspace switcher را باز کنید و Create را بزنید.
- برای workspace نام وارد کنید.
- اگر عضو یک سازمان هستید، تیم مناسب را انتخاب کنید.
- نوع Internal را انتخاب کنید و مشخص کنید دسترسی برای همه اعضای تیم باشد یا فقط برای شما و افراد دعوت‌شده.
- در پایان Create را بزنید.
اعضای تیم را دعوت کنید
workspace را باز کنید و از header گزینه Invite را انتخاب کنید. با ایمیل یا گزینه‌های موجود، اعضای تیم را دعوت کنید، نقش مناسب را برای آن‌ها انتخاب کنید و سپس Invite را بزنید. با تکامل workspace، کالکشن‌ها و APIهای عمومی، می‌توانید افراد بیشتری را اضافه کنید.
جزئیات workspace را ویرایش کنید
برای کامل کردن اطلاعات workspace، آن را باز کنید و در sidebar از مسیر Options و سپس Workspace overview وارد شوید. خلاصه و توضیح workspace را اضافه کنید تا اعضای تیم بدانند این فضا برای چه کاری است و کدام کالکشن‌ها در آن منبع اصلی تغییرات هستند.
این توضیحات را با تغییر روند کاری تیم و تکامل API به‌روز نگه دارید.
کالکشن‌های عمومی را fork کنید
برای اینکه workspace داخلی منبع اصلی کار تیمی شود، کالکشن‌های عمومی را از workspace عمومی به workspace داخلی fork کنید.
- workspace عمومی و کالکشنی را که می‌خواهید fork کنید باز کنید.
- کنار کالکشن گزینه View more actions و سپس Fork را انتخاب کنید.
- workspace تیمی یا داخلی خود را انتخاب کنید و Fork Collection را بزنید.
- همین مراحل را برای هر کالکشن عمومی تکرار کنید.
بعد از این مرحله، workspace داخلی شما می‌تواند محل اصلی آماده‌سازی تغییرات بعدی API باشد. وقتی تغییرات آماده انتشار شد، آن‌ها را با pull request به کالکشن عمومی منتقل کنید تا مصرف‌کنندگان API آخرین نسخه را در شبکه API Postman ببینند.
منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.