Start Debugging

Tag: openapi

10 posts

2026-08-09 csharp dotnet dotnet-11

Como servir documentação OpenAPI com Scalar em vez do Swagger UI no ASP.NET Core 11

Substitua UseSwaggerUI por MapScalarApiReference no ASP.NET Core 11: roteamento, múltiplos documentos, autenticação pré-preenchida, controle em produção, recursos sem CDN e as extensões OpenAPI exclusivas do Scalar.

2026-07-24 migration swashbuckle openapi

Migrar IOperationFilter e ISchemaFilter do Swashbuckle para transformadores de OpenAPI no .NET 11

Uma referência de migração filtro a filtro para mover o código de IOperationFilter e ISchemaFilter do Swashbuckle para os transformadores de operação e esquema integrados no .NET 11, com o mapeamento dos objetos de contexto e as mudanças do Microsoft.OpenApi v2 que quebram a compilação.

2026-07-14 csharp dotnet dotnet-11

Como retornar uma união tipada Results<T1, T2> de um endpoint de minimal API no ASP.NET Core 11

Declare o tipo de retorno do handler como Results<Ok<T>, NotFound> e retorne TypedResults.Ok / TypedResults.NotFound: a união oferece verificação em tempo de compilação de que o handler só retorna o que declara, e ela se autodescreve ao OpenAPI para que você nunca escreva .Produces na mão. Cobre handlers assíncronos, o limite de seis tipos e testes no ASP.NET Core 11.

2026-07-12 csharp dotnet dotnet-11

Como personalizar o documento OpenAPI com AddOperationTransformer e AddSchemaTransformer no ASP.NET Core 11

Um mergulho profundo no pipeline de transformadores OpenAPI embutido no .NET 11: transformadores de operação versus de esquema, os objetos de contexto, a ordem de execução, transformadores ativados por DI e receitas para cabeçalhos, respostas, exemplos e ajustes por propriedade.

2026-06-16 migration swashbuckle openapi

Migrar do Swashbuckle para o gerador de OpenAPI integrado no .NET 11

Uma migração passo a passo do Swashbuckle.AspNetCore para o Microsoft.AspNetCore.OpenApi no .NET 11: trocar AddSwaggerGen por AddOpenApi, converter os filtros de operação, esquema e documento em transformadores, manter uma UI e as mudanças incompatíveis do Microsoft.OpenApi v2 que pegam você.

2026-06-08 csharp dotnet dotnet-11

Como expor OpenAPI sem Swashbuckle no ASP.NET Core 11

O Swashbuckle saiu dos templates do ASP.NET Core. Veja como gerar e servir um documento OpenAPI no .NET 11 com o pacote integrado Microsoft.AspNetCore.OpenApi: AddOpenApi, MapOpenApi, transformadores, múltiplos documentos, geração em tempo de build e uma interface por cima.

2026-05-24 dotnet-11 aspnetcore openapi

ASP.NET Core no .NET 11 Preview 4 ensina o metodo HTTP QUERY ao OpenAPI

O .NET 11 Preview 4 faz a geracao de OpenAPI no ASP.NET Core reconhecer o HTTP QUERY como uma operacao de primeira classe no OpenAPI 3.2, com um fallback elegante para documentos 3.0 e 3.1.

2026-04-28 dotnet-10 aspnetcore openapi

Asp.Versioning 10.0 finalmente se entende com o OpenAPI nativo do .NET 10

Asp.Versioning 10.0 é o primeiro release que tem como alvo o .NET 10 e o novo pipeline do Microsoft.AspNetCore.OpenApi. O guia de 23 de abril de Sander ten Brinke mostra como registrar um documento OpenAPI por versão da API com WithDocumentPerVersion().

2026-04-28 aspnetcore openapi swagger

Como adicionar fluxos de autenticação OpenAPI ao Swagger UI no .NET 11

No .NET 11 o documento OpenAPI é gerado por Microsoft.AspNetCore.OpenApi e o Swagger UI não vem mais no template. Veja como conectar Bearer, OAuth2 com PKCE e OpenID Connect para que o botão Authorize realmente funcione.

2026-04-24 dotnet dotnet-11 csharp

Como Gerar Código de Cliente Fortemente Tipado a partir de uma Especificação OpenAPI no .NET 11

Use o Kiota, o gerador oficial de OpenAPI da Microsoft, para produzir um cliente C# fluent e fortemente tipado a partir de qualquer especificação OpenAPI. Passo a passo: instalar, gerar, conectar à injeção de dependência do ASP.NET Core e gerenciar autenticação.