Tag: openapi

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.

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.

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.

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.

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

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.

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.

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.