Bu yazımda şuradaki oluşturduğumuz micro servis yapısına swagger entegre edeceğim. Swagger sayesinde controller’daki metodları kolaylıkla test edebiliriz ve api larımızı dökümante edebiliriz.
Swagger ekleme işlemini sadece Basket servisine ekleyeceğim diğer product ve order servisleri içinde bu işlem aynı olacaktır.
Öncelikle Nuget ‘ten Swashbuckle.AspNetCore paketini Basket servisine yüklüyoruz.
Ardından Startup.cs dosyasında ConfigureServices fonksiyonuna aşağıdaki satırları ekliyoruz.
services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new OpenApiInfo { Title = "Basket API", Version = "v1" });
});
Ardından api’ye çalıştığında swagger’ı kullanmasını söylememiz gerekiyor. Configure fonksiyonunda bu işlemi yapıyoruz.
app.UseSwagger();
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
}
);
Swagger’ı eklemek bu kadar kolay localhost:PORT/swagger diyerek swagger ile oluşturduğumuz dökümanı görebiliriz.