OpenAPI v2 zu v3-Wandler

OpenAPI v2 zu v3-Wandler

Fügen Sie eine Swagger 2.0-Spezifikation ein und erhalten Sie eine gültige OpenAPI 3.0.3-Version zurück, entweder im JSON- oder YAML-Format. Der Converter wendet die offiziellen strukturellen Zuordnungsregeln an — er bewegt definitions unter components/schemas, fasst host, basePathund schemes hinein serverszusammen, teilt consumes und produces in pro-Operation content Karten auf und verändert Formparameter und Sicherheitsdefinitionen — damit Ihre Spezifikation mit modernen OpenAPI-Tools funktioniert.

Nutzung

1. Fügen Sie Ihre Swagger 2.0-Spezifikation in das Eingabefeld ein. JSON und YAML werden beide akzeptiert; das Format wird automatisch erkannt.
2. Wählen Sie das Ausgabeformat: behalten Sie das Eingabeformat bei oder zwingen Sie auf JSON oder YAML.
3. Verlassen Fehlende erforderliche Felder beheben um erforderliche v3-Felder wie info.title, info.versionzu automatisch füllen und fehlende Antwortbeschreibungen, wenn die v2-Quelle sie weglässt.
4. Lesen Sie die Konversionszusammenfassung und alle Warnungen, die oben im Ausgabebereich angezeigt werden, und kopieren Sie dann oder laden Sie die resultierende OpenAPI 3.0.3-Spezifikation herunter.

Funktionen

• JSON und YAML ein, JSON oder YAML aus — wählen Sie das Format, das Ihnen bevorzugt ist, oder spiegeln Sie das Eingabeformat wider.
• Strukturelle Zuordnung — definitions → components/schemas, securityDefinitions → components/securitySchemes, parameters/responses werden unter componentsaufgenommen, und jedes $ref Pointer wird neu geschrieben, um übereinstimmend zu sein.
• Server aus Host, basePath, Schemata — kombiniert in die v3 servers Array, wobei HTTPS bevorzugt wird, wenn mehrere Schemata aufgeführt sind.
• Inhaltsgestaltung — consumes und produces werden in pro-Operation requestBody.content und responses[*].content Karten umgewandelt.
• Body und Formparameter — in: body wird zu einem v3 requestBodyund in: formData Felder werden in ein multipart/form-data oder application/x-www-form-urlencoded Anfragekörper-Schema gruppiert.
• Sicherheitsfluss-Upgrade — OAuth2 flow Werte werden auf das v3 flows Objekt (implicit, password, clientCredentials, authorizationCode).
• Patch-Modus — wenn aktiviert, füllt er fehlende erforderliche Felder aus, damit das Ergebnis einen v3-Validator besteht, anstatt auf kleinere Quellfehler zu scheitern.
• Konversionszusammenfassung und Warnungen — Anzahl der Pfade, Schemata und Sicherheitsdefinitionen, die konvertiert wurden, sowie Warnungen für alles, was nicht ein-zu-ein-mit einer Zuordnung möglich war.
• Laufend im Browser — Ihre Spezifikation verlässt die Seite nie.