OpenAPI Swagger Editor

Zweck & Benutzerabsicht: Dieses Tool bietet eine fokussierte OpenAPI/Swagger-Bearbeitungsengine für Entwickler, API-Product-Manager und QA-Ingenieure, die API-Definitionen erstellen, validieren und pflegen. Anwendungsfälle umfassen das Entwerfen neuer Pfade, das Konfigurieren von Komponenten und das Validieren gegen OpenAPI 3.x vor Code-Generierung oder Client-Scaffolding. Der Benutzer schreibt YAML oder JSON, prüft die Syntax und führt eine Schema-Validierung durch, um strukturelle Fehler frühzeitig zu erkennen. Typische Benutzer sind Backend-Entwickler, API-Architekten und Plattform-Teams, die Microservices integrieren. Kernlogik & Funktionen: Erforderliche Funktionen umfassen: YAML/JSON-Parsing, OpenAPI-Versions-Erkennung, Syntaxprüfung, Schema-Validierung gegen OpenAPI 3.x, Auto-Vervollständigungsvorschläge für Pfade und Schemas, Unterstützung bei der Auflösung von $ref, Generierung von Beispielantworten, Import/Export von Spezifikationsdateien. Optionale/fortgeschrittene Funktionen umfassen: Multi-Datei-Komposition mit $ref über Dateien hinweg, Linters, Diff/Merge und Kollaborations-Workflows mit Exportformaten (JSON/YAML) und Entwurfs-/Schweregrad-Ebenen. Das Tool erzwingt Standardstrukturen (info, servers, paths, components) und bietet nicht-destruktive Bearbeitung zur Erhaltung existierender Spezifikationen. Eingaben & Ausgaben & Berechnungen: Eingaben umfassen: spec_text (YAML/JSON), spec_format, target_openapi_version, allow_remote_refs. Ausgaben umfassen: validated_spec, errors, warnings und normalized_ref_map; zusätzlich eine Liste nicht aufgelöster $ref-Standorte. Algorithmen & Berechnungen: Validierung nutzt OpenAPI 3.x-Schema-Regeln plus JSON-Schema-Beschränkungen für Komponenten; Dereferenzierung von $ref validiert verschachtelte Strukturen; kann Beispieldaten aus Schemata generieren; kann Diff gegen eine gespeicherte Version erzeugen, wenn angegeben. Fehlerbehandlung, Lokalisierung & Geltungsbereich: Behandelt Syntaxfehler, fehlende Pflichtfelder, nicht unterstützte Versionen, zirkuläre $ref; Fehler bei Remote-Refs; große Spezifikationen können Leistungslimits erreichen. Lokalisierung folgt OpenAPI-Standards mit Englisch als Standard; keine Währungs- oder länderspezifischen Aspekte. Annahmen & Ausschlüsse: Geht davon aus, dass Spezifikationen OpenAPI-Normen folgen; keine Code-Generierung, Laufzeit-Server oder UI-Renderings; kein Hosting-Service.