Start Debugging

Tag: openapi

15 posts · Página1de2

2026-08-19 errors swashbuckle openapi

Correção: não é possível gerar OpenAPI 3.0 após atualizar o Swashbuckle.AspNetCore para a v9

Swashbuckle 8 e versões posteriores emitem openapi 3.0.4, não 3.0.1, e não existe um OpenApiSpecVersion para versões de patch. Por que mudou e quatro formas de fixar a string que sua ferramenta espera.

2026-08-19 errors openapi swagger

Correção: Swagger UI mostra Unable to render this definition após atualizar para .NET 11

O ASP.NET Core 11 emite openapi 3.2.0 por padrão e o Swagger UI abaixo de 10.1.5 o rejeita. Atualize Swashbuckle.AspNetCore.SwaggerUI ou fixe OpenApiVersion em OpenApi3_1.

2026-08-15 comparison csharp dotnet

Scalar vs Swagger UI para documentação OpenAPI no ASP.NET Core 11

O Scalar entrega 1,02 MiB de JavaScript comprimido com gzip e um construtor de requisições bem melhor. O Swagger UI entrega 514 KiB e renderiza OpenAPI 3.2, que é o que o .NET 11 agora emite por padrão. Payloads medidos, a lacuna do 3.2, roteamento por endpoints dos dois lados e os detalhes de autenticação que decidem.

2026-08-12 errors aspnetcore dotnet

Correção: The 'interceptors' feature is not enabled in this namespace

CS9137 vem do gerador de código-fonte do Microsoft.AspNetCore.OpenApi. Adicione InterceptorsNamespaces a todo projeto que chama AddOpenApi, não só ao que tem o PackageReference.

2026-08-11 errors aspnetcore dotnet

Correção: The type or namespace name 'OpenApiReference' could not be found

OpenApiReference foi removido no Microsoft.OpenApi 2.0. Trocar o using para Microsoft.OpenApi não basta: substitua cada uso por uma referência tipada como OpenApiSchemaReference.

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ê.