Swagger سریع ترین و راحت ترین روش برای مستند سازی API REST است. Swagger مستندات را بر اساس ساختار کد تولید می کند و از این رو توسعه دهندگان بجای صرف زمان برای نوشتن مستندات تمام زمان و انرژی خود را بر روی توسعه محصول متمرکز می کنند.
همان طور که در مقاله مستند سازی خودکار api ها در asp.net core با استفاده از swagger مشاهده کردید، این ابزار به راحتی و با چند خط کد به پروژه ی ما اضافه می شود و مستندات را برای ما تولید می کند. اما مواردی وجود دارد که نیاز داریم خودمان کانفیگ های swagger را تغییر دهیم و پشتیبانی از این موارد را به swagger اضافه کنیم. این موارد معمولا در همه پروژه ها استفاده ای ندارند و برای همین Swagger به صورت پیش فرض این موارد را به کانفیگ اضافه نمی کند و ما مجبوریم خودمان دست بکار شویم. یکی از این موارد آپلود فایل می باشد. ما در این مقاله به آموزش آپلود فایل در Swagger Ui می پردازیم.
یک پروژه Asp.Net Core ایجاد نمایید و طبق آموزش شخصی سازی swagger در asp.net core را به آن اضافه کنید. سپس یک کنترلر به نام File ایجاد کنید.