Оё таҷрибаи истифодаи асбоби Swagger барои ҳуҷҷатгузорӣ ва озмоиши API-ҳо доред?

Бале, Swagger — популярӣ асбоб барои ҳуҷҷатгузорӣ ва озмоиши API-ҳои REST мебошад. Он имкон медиҳад, ки автоматӣ ҳуҷҷатгузории интерактивӣ бар асоси шарҳҳо дар код ё махсусгардонии OpenAPI эҷод кунад. Дар C# одатан китобхонаи Swashbuckle истифода мешавад, ки бо ASP.NET Core ҳамҷоя шуда, Swagger UI-ро мебарорад.

Масалан, дар ASP.NET Core истифодаи Swagger:

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-ро бубинанд ва дар браузер мустақиман дархостҳо иҷро кунанд.