###### tags: `ASP.Net Core 3` `Swagger`
# ASP.Net Core 3.1 建立API文件(NSwag)

> 參考文章[NSwag 與 ASP.NET Core 使用者入門](https://docs.microsoft.com/zh-tw/aspnet/core/tutorials/getting-started-with-nswag?view=aspnetcore-3.1&tabs=visual-studio)

1.安裝套件

dotnet add TodoApi.csproj package NSwag.AspNetCore

2.注入DI

  services.AddSwaggerDocument();


3.在 Startup.Configure 方法中，啟用中介軟體為產生的 Swagger 規格和 SwaggerUI 提供服務

    app.UseOpenApi();
    app.UseSwaggerUi3();


啟動應用程式。 瀏覽至：
http://localhost:<port>/swagger 以檢視 Swagger UI。
http://localhost:<port>/swagger/v1/swagger.json 以檢視 Swagger 規格

完成後會將所有Web API打包成一個美化過後的文件參考網站