اضافه کردن Swagger در ASP.NET Core 2.0 Web API

سلام دوستان.

حتما میدونید Swagger چیه اگه نمیدونید برید اینجا.

خوب حالا که متوجه شدید چه ابزاره خوبیه بریم ازش استفاده کنیم:

اول یه پروژه ASP.NET Core 2.0 WEB API بسازید

از طریق NuGet پکیج زیر را نصب کنید:

Swashbuckle.AspNetCore

خوبه. خسته نباشید.

حالا باید یه چند تا خط کد هم بزاریم تو Startup.cs پروژه.

قطعه کد زیر رو در قسمت ConfigureServices بزارید

services.AddSwaggerGen(c =>
{
        c.SwaggerDoc("v1", new Info
                {
                         Version = "v1",
                                 Title = "My API",
                });
        });

بعدشم باید SwaggerUI رو فعال کنید. واسه همین میایم تو قسمت Configure کدهای زیرو استفاده میکنیم :

app.UseSwagger();
app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
    });

خوب اینم تموم شد.

حالا یه مرحله دیگه مونده.اونم اینه که بالای هر اکشنی attribute زیرو بزارید:

تموم شد برین به آدرس زیر و از Swagger لذت ببرین.

 http://localhost:{your port number}/swagger