API-лерди документтештирүү жана тестирлөө үчүн Swagger куралын колдонуу боюнча тажрыйбаңыз барбы?

Ооба, Swagger — бул REST API-лерди документтештирүү жана тестирлөө үчүн популярдуу инструмент. Ал автоматтык түрдө интерактивдүү документацияны коддогу же 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 сүрөттөмөсүн тез көрүүгө жана браузерден түздөн-түз суроо-талаптарды жөнөтүүгө мүмкүндүк берет.