API-lərin sənədləşdirilməsi və test edilməsi üçün Swagger alətindən istifadə təcrübəniz varmı?

Bəli, Swagger REST API-ləri sənədləşdirmək və sınaqdan keçirmək üçün məşhur alətdir. O, kodda və ya OpenAPI spesifikasiyalarında qeyd olunan şərhlərə əsaslanaraq interaktiv sənədləri avtomatik yaradır. C#-da adətən Swashbuckle kitabxanası istifadə olunur, bu, ASP.NET Core ilə inteqrasiya edir və Swagger UI yaradır.

ASP.NET Core-da Swagger-ın inteqrasiyası nümunəsi:

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", "Mənim API V1");
    });

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

Bu, inkişaf etdiricilərə və sınaqçılara API-nin təsvirini tez görmək və brauzerdən birbaşa sorğular etmək imkanı verir.