Mejorar la experiencia del desarrollador de una API con documentación de Swagger

Principiante
Desarrollador
Azure
CLI de Azure
ASP.NET Core

Aprenda a documentar una API existente, escrita en C#/ASP.NET Core, mediante Swashbuckle, Swagger/OpenAPI y Swagger UI.

Objetivos de aprendizaje

Objetivos de este módulo:

  • Aprender sobre Swashbuckle, OpenAPI, Swagger UI.
  • Habilitar OpenAPI para una API de C#/ASP.NET Core.
  • Usar Swashbuckle en una API de C#/ASP.NET Core.
  • Generar y ver la documentación de la API, con OpenAPI.

Requisitos previos

  • Experimentar con el diseño y la implementación de API de REST
  • Experimentar con el desarrollo de aplicaciones básicas de ASP.NET Core
  • Instalaciones locales del SDK de .NET
  • Visual Studio Code
  • Extensión de C# para Visual Studio Code