Dica ASP.NET Core: versionando APIs REST sem grandes complicações
Implementar uma estratégia eficaz de versionamento em APIs REST nem sempre é uma tarefa das mais fáceis. É bastante comum que as implementações adotadas recorram a muito código duplicado, o que certamente prejudicará a manutenção de projetos deste tipo ao longo do tempo.
O print desta dica é de uma solução desenvolvida especificamente para ASP.NET Core, descomplicando o versionamento de APIs e possuindo uma excelente integração com Swagger/OpenAPI: trata-se do projeto ASP.NET API Versioning. Esta é uma iniciativa mantida pela própria Microsoft e que facilita em muito o trabalho de versionar APIs REST, permitindo até mesmo marcar no conteúdo gerado para o Swagger que uma versão se encontra como Deprecated.
Disponibilizei um repositório com uma implementação baseada no ASP.NET API Versioning no GitHub:
https://github.com/renatogroffe/ASPNETCore6-REST_API-Swagger-Versioning_ContagemAcessos
Caso ache útil esta solução, peço por favor um ⭐️ no repositório apoiando. Fica também o convite para que vocês me sigam lá no GitHub!
Este exemplo foi demonstrado em detalhes em uma live recente do Canal .NET, cuja gravação está disponível no YouTube:
E também já publiquei no meu blog um artigo sobre o projeto ASP.NET API Versioning:
.NET 5 + ASP.NET Core + Swagger: descomplicando o versionamento de APIs REST
E finalizo este post com um convite…
Segunda 20/06 às 21:00 — horário de Brasília — teremos mais um evento online e gratuito no canal Canal .NET.
Esta live trará novas dicas, truques e alternativas úteis para o desenvolvimento Back-End e de APIs REST com .NET 6, C#, ASP.NET Core e Azure Functions. Ao longo da apresentação será coberto o uso de diferentes frameworks, serviços na nuvem, mensageria e boas práticas de forma a facilitar e tornar mais dinâmica a implementação de soluções baseadas na plataforma .NET no seu dia a dia.
Teremos também algumas novidades do .NET 7 em exemplos práticos!
Para participar faça sua inscrição no link a seguir, a transmissão acontecerá via YouTube:
