Großes Update für OpenAPI.NET

Dienstag, 18. November 2025

OpenAPI.NET hat sein bisher umfangreichstes Update veröffentlicht, gleich zwei neue Versionen bringen die Bibliothek technisch auf ein neues Niveau. Wenn du moderne, interoperable APIs baust oder dokumentierst, lohnt sich ein genauer Blick auf die Neuerungen in v2 und v3.

Was ist neu in OpenAPI.NET v2?

Mit v2 hält erstmals die OpenAPI Specification 3.1.0 vollständig Einzug. Für dich bedeutet das vor allem schlankere Abläufe und bessere Performance:

• Schnellere Verarbeitung: Durch System.Text.Json reduziert sich die Parsing-Zeit um rund 50 %, gleichzeitig sinkt der Speicherbedarf beim JSON-Parsing um etwa 35 %.
• Sauberere API-Oberfläche: Eigenschaften vom Typ json nutzen jetzt das native JSON-Node-API.
• Lazy Reference Resolution: Große Dokumente mit vielen $ref-Einträgen laden spürbar schneller.
• Weniger Abhängigkeiten: JSON-Handling funktioniert ohne zusätzliche Pakete.
• Volle Unterstützung von OpenAPI 3.1: Inklusive Serialisierung und vollständig überarbeitetem Modell.

Was bringt OpenAPI.NET v3?

Version 3 legt noch einmal nach und erweitert die Bibliothek um vollständigen Support für OpenAPI 3.2.0. Besonders relevant:

• Erweiterte Media-Type-Unterstützung: Neue Eigenschaften für Encoding und Schema-Definitionen.
• Hierarchische Tags: Mit kind, summary und parent kannst du Tags strukturierter organisieren.
• Sicherheitsfeatures: Unterstützung für Device Authorization Flow und ein neues deprecated-Flag.
• Erweiterte Beispiele: Zusätzliche Daten- und Serialisierungswerte.
• Umfassendere Parameteroptionen: Neue Locations und Styles.

OpenAPI.NET steckt unter anderem in Swashbuckle, Semantic Kernel, NSwag und .NET selbst. Mit den neuen Versionen bist du besser für kommende .NET-Versionen – insbesondere .NET 10 mit nativer OpenAPI-Unterstützung – vorbereitet und profitierst von stabilerer, schnellerer Dokumentverarbeitung.

Upgrade? Erst v2, dann v3

Für das Aktualisieren gibt es detaillierte Upgrade-Guides, die Schritt für Schritt durch die Migration führen. Die Empfehlung der Maintainer ist klar: zuerst auf v2, anschließend auf v3 wechseln.

Open Source, gemeinsam weiterentwickelt

Das Release ist das Ergebnis vieler Beiträge aus der Community. Das Team lädt ausdrücklich ein, sich weiterhin zu beteiligen. Wenn du APIs im .NET-Ökosystem entwickelst, ist dieses Update sehr wertvoll: mehr Geschwindigkeit, breitere Spezifikationsunterstützung und ein deutlich moderneres Fundament für alles, was du in Zukunft bauen möchtest.

Mehr erfahren