Tag: openapi

Swashbuckle 8 und neuer geben openapi 3.0.4 aus, nicht 3.0.1, und es gibt keine OpenApiSpecVersion für Patch-Versionen. Warum sich das geändert hat und vier Wege, die erwartete Zeichenkette zu erzwingen.

ASP.NET Core 11 gibt standardmäßig openapi 3.2.0 aus, und Swagger UI unter 10.1.5 lehnt das ab. Swashbuckle.AspNetCore.SwaggerUI aktualisieren oder OpenApiVersion auf OpenApi3_1 setzen.

Scalar liefert 1,02 MiB gzip-komprimiertes JavaScript und einen deutlich besseren Request-Builder. Swagger UI liefert 514 KiB und rendert OpenAPI 3.2, was .NET 11 inzwischen standardmäßig ausgibt. Gemessene Payloads, die 3.2-Lücke, Endpoint-Routing auf beiden Seiten und die Authentifizierungsdetails, die entscheiden.

CS9137 stammt vom Source Generator in Microsoft.AspNetCore.OpenApi. Fügen Sie InterceptorsNamespaces in jedem Projekt hinzu, das AddOpenApi aufruft, nicht nur im Projekt mit der PackageReference.

OpenApiReference wurde in Microsoft.OpenApi 2.0 entfernt. Das using auf Microsoft.OpenApi zu ändern reicht nicht: Ersetzen Sie jede Verwendung durch eine typisierte Referenz wie OpenApiSchemaReference.

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.

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.

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.