Swashbuckle.AspNetCoreの調査

[f7q]

仕様変更箇所の確認

swagger/ui/index.html
⬇️
swagger/index.html

[f7q]

特定のコントローラ/アクションのドキュメントを出力する or しない

using Microsoft.AspNetCore.Mvc.ApiExplorer;
using Microsoft.AspNetCore.Mvc.Controllers;
public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddMvc();

        services.AddSwaggerGen(option =>
        {
            option.DocInclusionPredicate((name, apiDescription) =>
            {
                var controllerActionDescription = apiDescription.ActionDescriptor as ControllerActionDescriptor;

                // コントローラ名に Api が含まれていたらSwaggerの対象にする
                return controllerActionDescription?.ControllerName.Contains("Api") ?? false;
            });
            option.SwaggerDoc("orders", new Title { Name = "Order APIs", Version = "v1" });
        });
    }
}