وقتی workspace عمومی، کالکشنهای عمومی، مرتبسازی کالکشنها و workspace داخلی تیم آماده شد، میتوانید APIهای عمومی را منتشر کنید. قبل از انتشار، دوباره دادههای حساس مثل کلید API، توکن و مقدارهای داخلی را بررسی کنید تا چیزی به صورت عمومی منتشر نشود.
تجربه توسعهدهنده را ارزیابی کنید
قبل از عمومی کردن workspace و شروع ترویج API، خودتان مسیر کاربر تازه را طی کنید. از overview collection شروع کنید، مراحل دریافت دسترسی و اجرای requestها را انجام دهید و بررسی کنید کاربر چقدر سریع به اولین پاسخ موفق مثل 200 OK میرسد.
از چند نفر دیگر در تیم هم بخواهید همین مسیر را امتحان کنند. اگر workspace داخلی و fork کالکشنهای عمومی را آماده کردهاید، این تمرین کمک میکند تجربه واقعی مصرفکننده API را بهتر ببینید. بازخوردها را جمع کنید و تا زمانی که شروع کار روان نشده، کالکشنها و توضیحات را اصلاح کنید.
workspace را عمومی کنید
برای عمومی کردن workspace در Postman این مراحل را انجام دهید:
- در sidebar گزینه Options و سپس Workspace overview را باز کنید.
- تب Settings را باز کنید.
- در بخش Workspace type گزینه Change را انتخاب کنید.
- نوع Public را انتخاب کنید.
- اگر از شما درخواست تایید خواسته شد، در صورت نیاز یادداشتی اضافه کنید و Submit Request را بزنید.
- در پایان Save changes را انتخاب کنید.
بعد از این مرحله، workspace عمومی و کالکشنهای آن در شبکه API Postman در دسترس مصرفکنندگان قرار میگیرند.
بعد از عمومی شدن
- صفحه API را از دید یک کاربر جدید بررسی کنید.
- مطمئن شوید لینکهای راهنما، احراز هویت و environmentها درست کار میکنند.
- کالکشنها را با تغییرات API بهروز نگه دارید.
- از دادههای استفاده و بازخورد کاربران برای بهتر کردن تجربه شروع استفاده کنید.
منبع آموزشی: Postman Docs، بازنویسی و سادهسازیشده برای کاربران فارسیزبان.