Ներկայում եք փորձառու Swagger գործիքի օգտագործման մեջ API-ների փաստաթղթավորման և փորձարկման համար:

Այո, 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-ի նկարագրությունը և ուղարկել հարցումներ ուղղակիորեն բրաուզերում։