Visual Studio 2022: dicas para uma maior produtividade nos testes de APIs REST
Neste post apresento 2 exemplos de uso de funcionalidades recentemente adicionadas ao Visual Studio 2022, visando uma maior produtividade nos testes com APIs REST:
- A possibilidade de executar testes de APIs REST a partir de scripts (arquivos .http), com o envio de requisições HTTP a partir da própria IDE;
- A funcionalidade chamada Endpoints Explorer, em que são listados todos os endpoints disponibilizados por projetos que correspondam a implementações de APIs REST em uma Solution.
Testando APIs REST a partir da própria IDE do Visual Studio
Testar APIs REST durante o debugging de uma aplicação no Visual Studio IDE é, sem sombra de dúvidas, um tipo de necessidade extremamente comum. Por muito tempo a única opção para isso envolvia utilitários externos como Postman, Insomnia, o próprio Visual Studio Code (através de alguma extensão) e até mesmo o uso de um browser (com o envio de requisições podendo acontecer a partir de uma interface gráfica como a do Swagger).
O suporte a arquivos .http foi disponibilizado buscando simplificar bastante este processo. Vale destacar que esta funcionalidade foi inspirada na extensão REST Client, um plugin bastante popular para o Visual Studio Code e que já abordei em outros artigos neste blog:
Dicas de Visual Studio Code: testando APIs REST com instruções curl via script | pt 15
Dicas de Visual Studio Code: testando APIs REST via scripts | pt 14
Podemos observar esta nova capacidade em uso na imagem seguinte, obtida ao se realizar o debugging de uma API REST baseada em .NET 8 e Minimal APIs (este mesmo recurso pode ser empregado em projetos baseados em Controllers):
Já o resultado desse teste está na próxima imagem:
Em um vídeo recente do Canal .NET no YouTube também demonstrei na prática a utilização de arquivos .http no teste de APIs REST:
Endpoints Explorer
O Endpoints Explorer é uma funcionalidade do Visual Studio 2022 que lista todos os endpoints disponibilizados por APIs REST em projetos ASP.NET Core (tanto com Minimal APIs, quanto com Controllers), detalhando inclusive parâmetros/payloads esperados para um endpoint e simplificando até testes de APIs a partir de arquivos .http. Podemos observar um exemplo de uso deste recurso na imagem a seguir:
Apresentei essa funcionalidade em outro vídeo recente e também gratuito do Canal .NET no YouTube:
