Melhorar a experiência do desenvolvedor de uma API com a documentação do Swagger

Iniciante
Desenvolvedor
Azure
CLIs do Azure
ASP.NET Core

Saiba como documentar uma API existente, escrita em C#/ASP.NET Core, usando o Swashbuckle, OpenAPI/Swagger e Swagger UI.

Objetivos de aprendizagem

Neste módulo, você vai:

  • Saber mais sobre Swashbuckle, OpenAPI, Swagger UI
  • Habilitar o OpenAPI para uma API do C#/ASP.NET Core
  • Usar o Swashbuckle em uma API do C#/ASP.NET Core
  • Gerar e exibir a documentação da API com o OpenAPI

Pré-requisitos

  • Experiência com a API REST de design e implementação
  • Experiência de desenvolvimento de aplicativos ASP.NET Core básicos
  • Instalações locais do SDK do .NET
  • Visual Studio Code
  • Extensão do C# para Visual Studio Code