API-ების დოკუმენტაციისა და ტესტირებისათვის Swagger-ის ინსტრუმენტის გამოყენების გამოცდილება გაქვთ?

დიახ, Swagger არის პოპულარული ინსტრუმენტი REST API-ების დოკუმენტაციისა და ტესტირებისათვის. ის ავტომატურად ქმნის ინტერაქტიულ დოკუმენტაციას კოდის ან OpenAPI სპეციფიკაციების კომენტარებზე დაყრდნობით. C#-ში ხშირად გამოიყენება Swashbuckle ბიბლიოთეკა, რომელიც ინტეგრირებულია ASP.NET Core-თან და ქმნის Swagger UI-ს.

მაგალითი Swagger-ის ინტეგრაციის ASP.NET Core-ში:

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers();
    services.AddSwaggerGen();
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseSwagger();
    app.UseSwaggerUI(c =>
    {
        c.SwaggerEndpoint("/swagger/v1/swagger.json", "ჩემი API V1");
    });

    app.UseRouting();
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
}

ეს საშუალებას აძლევს დეველოპერებს და ტესტერებს სწრაფად ნახონ API-ის აღწერა და პირდაპირ ბრაუზერიდან გააგზავნონ მოთხოვნები.