OpenAPI-/Swagger-JSON-Kompressor
Füge eine OpenAPI-3.x- oder Swagger-2.0-JSON-Spezifikation ein, um Beschreibungen, Beispiele und x--Erweiterungen zu entfernen – verringert die Größe der Spezifikation für SDK-Generierungspipelines und API-Gateway-Importe. Läuft vollständig in deinem Browser, ohne Anmeldung.
Paste an OpenAPI 3.x or Swagger 2.0 JSON specification to remove descriptions, examples, and x- extensions - reduces spec size for SDK generation pipelines and API gateway imports. Runs entirely in your browser.
Compression Options
Warum unseren OpenAPI-Kompressor verwenden?
- Sofortige OpenAPI-Spezifikationskompression: Füge eine beliebige OpenAPI-3.x- oder Swagger-2.0-JSON-Spezifikation ein und komprimiere sie sofort in deinem Browser – entfernt Beschreibungen, Beispiele und x--Erweiterungen in Millisekunden.
- Sicherer Online-OpenAPI-Kompressor: Deine API-Spezifikation verlässt nie dein Gerät. Die gesamte Kompression läuft lokal im Browser – sicher für interne oder proprietäre API-Spezifikationen mit sensiblen Endpoint-Informationen.
- Granulare Komprimierungsoptionen: Wähle genau, was entfernt wird – Beschreibungen, Zusammenfassungen, Beispiele, x--Erweiterungen, deprecated-Flags oder JSON-Leerraum – mit Live-Vorschau der komprimierten Ausgabe.
- 100 % kostenlos für immer: Komprimiere so viele OpenAPI-Spezifikationen, wie du brauchst, völlig kostenlos. Ohne Konto, ohne Abo, ohne Dateigrößenlimit und ohne Werbung.
Was ist OpenAPI-Spezifikationskompression?
OpenAPI-Spezifikationskompression ist das Entfernen reiner Dokumentationsfelder aus einer OpenAPI-JSON-Spezifikation, um ihre Größe für programmatische Anwendungsfälle wie SDK-Generierung, API-Gateway-Importe und CI/CD-Pipelines zu verringern. Große OpenAPI-Spezifikationen können mehrere Megabyte erreichen, wenn sie ausschweifende Beschreibungen, Inline-Beispiele und Anbieter-Erweiterungsfelder enthalten – von denen keines für die Codegenerierung nötig ist. Unser kostenloser OpenAPI-Kompressor entfernt diese Felder in deinem Browser und zeigt genau, was entfernt wurde.
So funktioniert unser OpenAPI-Kompressor
- Füge deine Spezifikation ein: Kopiere deine OpenAPI-3.x- oder Swagger-2.0-JSON-Spezifikation und füge sie in das Eingabefeld ein. Nutze die Beispielschaltfläche, um eine Muster-Spezifikation zu laden.
- Wähle die Komprimierungsoptionen: Wähle aus, welche Felder entfernt werden – Beschreibungen, Zusammenfassungen, Beispiele, x--Erweiterungen, deprecated-Flags oder JSON-Leerraum. Die Ausgabe wird sofort aktualisiert.
- Kopieren oder herunterladen: Kopiere die komprimierte Spezifikation in die Zwischenablage oder lade sie als .json-Datei herunter – und nutze sie dann in deinem SDK-Generator oder API-Gateway.
Was bei der Kompression entfernt wird
- Beschreibungen: alle „description“-Felder aus Pfaden, Operationen, Parametern, Request-Bodies, Responses und Schemas – nur Dokumentation, von Generatoren nicht verwendet.
- Beispiele: die Felder „example“ und „examples“ aus Schemas und Parametern – nur für das Rendering der Dokumentation genutzt.
- x--Erweiterungen: alle Anbieter-Erweiterungsfelder, die mit x- beginnen – interne Metadaten, die von API-Management-Tools hinzugefügt werden.
- JSON-Leerraum: alle Einrückungen, Zeilenumbrüche und Leerzeichen zwischen Tokens – erzeugt eine einzeilige, minifizierte JSON-Ausgabe.
Was erhalten bleibt
Alle strukturellen Felder, die für SDK-Generierung und API-Gateway-Importe nötig sind, bleiben vollständig erhalten: Pfade, HTTP-Methoden, Operations-IDs, Parameter (name, in, required, schema), Request-Bodies, Response-Statuscodes, Response-Schemas, Komponentendefinitionen, Sicherheitsschemata und Server-URLs. Die komprimierte Spezifikation ist für alle programmatischen Anwendungsfälle funktional identisch mit dem Original.
Häufig gestellte Fragen
Ein OpenAPI-Kompressor entfernt ausschweifende Felder wie Beschreibungen, Beispiele und x--Erweiterungen aus OpenAPI-JSON-Spezifikationen, um ihre Größe für SDK-Generierung, API-Gateway-Importe und CI/CD-Pipelines zu verringern. Unser kostenloser Online-OpenAPI-Kompressor läuft vollständig in deinem Browser – ohne Anmeldung oder Server-Upload.
Nein. SDK-Generatoren (OpenAPI Generator, Swagger Codegen, Kiota) nutzen nur die strukturellen Felder – Pfade, Operationen, Parameter, Request-Bodies, Response-Schemas und Komponentendefinitionen. Beschreibungen und Beispiele sind reine Dokumentationsfelder, die den generierten Code nicht beeinflussen.
Ja, vollständige Privatsphäre ist garantiert. Die gesamte Kompression läuft clientseitig in deinem Browser. Deine OpenAPI-Spezifikation – die interne Endpoint-Pfade, Authentifizierungsschemata und proprietäre Datenmodelle enthalten kann – verlässt nie dein Gerät und wird nie auf einen Server hochgeladen.
Ja. Der OpenAPI-Kompressor ist 100 % kostenlos, ohne Anmeldung, ohne Abo, ohne Limits für die Spezifikationsgröße und ohne Werbung. Du kannst so viele Spezifikationen komprimieren, wie du brauchst.
In OpenAPI 3.x ist „summary“ eine kurze einzeilige Beschreibung einer Operation (angezeigt in der Navigation der API-Dokumentation), während „description“ eine längere markdown-formatierte Erklärung ist. Beide sind reine Dokumentationsfelder – ihr Entfernen hat keinen Einfluss auf die SDK-Generierung oder das Verhalten von API-Gateways.
x--Erweiterungsfelder sind anbieterspezifische Metadaten, die von API-Management-Tools, Gateways oder internem Tooling hinzugefügt werden (z. B. x-rate-limit, x-internal-id, x-amazon-apigateway-integration). Für die SDK-Generierung können sie gefahrlos entfernt werden, für bestimmte API-Gateway-Importe können sie jedoch erforderlich sein. Prüfe die Dokumentation deines Gateways, bevor du sie entfernst.
Ja. Der Kompressor funktioniert mit Swagger-2.0- (swagger: "2.0") und OpenAPI-3.0/3.1-JSON-Spezifikationen (openapi: "3.x.x"). Dieselben Felder (Beschreibungen, Beispiele, x--Erweiterungen) existieren in beiden Formaten und werden von derselben Logik entfernt.
Die aktuelle Version des Kompressors unterstützt nur JSON-Eingaben. Um eine YAML-Spezifikation zu komprimieren, konvertiere sie zuerst mit einem YAML-zu-JSON-Konverter in JSON und komprimiere sie dann hier.