Start Debugging

Tag: openapi

10 Beiträge

2026-08-09 csharp dotnet dotnet-11

OpenAPI-Dokumentation mit Scalar statt Swagger UI in ASP.NET Core 11 bereitstellen

Ersetzen Sie UseSwaggerUI durch MapScalarApiReference in ASP.NET Core 11: Routing, mehrere Dokumente, vorausgefüllte Authentifizierung, Absicherung in Produktion, Assets ohne CDN und die Scalar-eigenen OpenAPI-Erweiterungen.

2026-07-24 migration swashbuckle openapi

Swashbuckle IOperationFilter und ISchemaFilter zu OpenAPI-Transformern in .NET 11 migrieren

Eine Filter-für-Filter-Migrationsreferenz, um IOperationFilter- und ISchemaFilter-Code von Swashbuckle zu den integrierten Operations- und Schema-Transformern in .NET 11 zu überführen, mit dem Mapping der Kontextobjekte und den Microsoft.OpenApi-v2-Änderungen, die die Kompilierung brechen.

2026-07-14 csharp dotnet dotnet-11

Wie man eine typisierte Results<T1, T2>-Union aus einem Minimal-API-Endpunkt in ASP.NET Core 11 zurückgibt

Deklarieren Sie den Rückgabetyp des Handlers als Results<Ok<T>, NotFound> und geben Sie TypedResults.Ok / TypedResults.NotFound zurück: Die Union bietet eine Prüfung zur Kompilierzeit, dass der Handler nur zurückgibt, was er deklariert, und beschreibt sich selbst gegenüber OpenAPI, sodass Sie .Produces nie von Hand schreiben. Behandelt asynchrone Handler, das Sechs-Typen-Limit und Tests in ASP.NET Core 11.

2026-07-12 csharp dotnet dotnet-11

OpenAPI-Dokument mit AddOperationTransformer und AddSchemaTransformer in ASP.NET Core 11 anpassen

Ein tiefer Einblick in die eingebaute OpenAPI-Transformer-Pipeline in .NET 11: Operation- vs. Schema-Transformer, die Kontextobjekte, die Ausführungsreihenfolge, DI-aktivierte Transformer sowie Rezepte für Header, Antworten, Beispiele und Anpassungen pro Eigenschaft.

2026-06-16 migration swashbuckle openapi

Von Swashbuckle zum integrierten OpenAPI-Generator in .NET 11 migrieren

Eine Schritt-für-Schritt-Migration von Swashbuckle.AspNetCore zu Microsoft.AspNetCore.OpenApi in .NET 11: AddSwaggerGen durch AddOpenApi ersetzen, Operations-, Schema- und Dokument-Filter in Transformer umwandeln, eine UI behalten und die Breaking Changes von Microsoft.OpenApi v2, die zubeißen.

2026-06-08 csharp dotnet dotnet-11

OpenAPI ohne Swashbuckle in ASP.NET Core 11 bereitstellen

Swashbuckle ist aus den ASP.NET-Core-Templates verschwunden. So generieren und servieren Sie in .NET 11 ein OpenAPI-Dokument mit dem integrierten Paket Microsoft.AspNetCore.OpenApi: AddOpenApi, MapOpenApi, Transformer, mehrere Dokumente, Generierung zur Build-Zeit und eine Oberfläche darüber.

2026-05-24 dotnet-11 aspnetcore openapi

ASP.NET Core in .NET 11 Preview 4 bringt OpenAPI die HTTP-Methode QUERY bei

.NET 11 Preview 4 sorgt dafur, dass die OpenAPI-Generierung in ASP.NET Core HTTP QUERY als erstklassige Operation in OpenAPI 3.2 erkennt, mit einem eleganten Fallback fur 3.0- und 3.1-Dokumente.

2026-04-28 dotnet-10 aspnetcore openapi

Asp.Versioning 10.0 spielt endlich gut mit dem integrierten OpenAPI in .NET 10 zusammen

Asp.Versioning 10.0 ist das erste Release, das auf .NET 10 und die neue Microsoft.AspNetCore.OpenApi-Pipeline abzielt. Sander ten Brinkes Anleitung vom 23. April zeigt, wie Sie pro API-Version ein eigenes OpenAPI-Dokument mit WithDocumentPerVersion() registrieren.

2026-04-28 aspnetcore openapi swagger

OpenAPI-Authentifizierungsflüsse in Swagger UI unter .NET 11 einrichten

Unter .NET 11 wird das OpenAPI-Dokument von Microsoft.AspNetCore.OpenApi erzeugt und Swagger UI ist nicht mehr Teil des Templates. So verkabeln Sie Bearer, OAuth2 mit PKCE und OpenID Connect, damit der Authorize-Button tatsächlich funktioniert.

2026-04-24 dotnet dotnet-11 csharp

Wie man stark typisierten Client-Code aus einer OpenAPI-Spezifikation in .NET 11 generiert

Verwenden Sie Kiota, Microsofts offiziellen OpenAPI-Code-Generator, um aus jeder OpenAPI-Spezifikation einen fluenten, stark typisierten C#-Client zu erzeugen. Schritt für Schritt: installieren, generieren, in ASP.NET Core Dependency Injection einbinden und Authentifizierung konfigurieren.