OpenAPI Validator Online – Schema-Konformitätsprüfung

Überprüfen Sie die Schemakonformität von OpenAPI 3.0–3.2 lokal. JSON und YAML – externe $ref werden nie abgerufen.

Laden…
Validieren Sie die OpenAPI-Dokumentation
Überprüfen Sie die Schemakonformität von OpenAPI 3.x lokal.

Hinweise des Entwicklers

Verwendet @scalar/openapi-Parser über dynamischen Import (nur Validierung). Unterstützt OpenAPI 3.0, 3.1 und 3.2. Live-Debounced-Validierung; Monaco-Eingabe mit JSON/YAML-Erkennung. Extern / URL $ref werden nie abgerufen. Interne #/…-Referenzen werden durch Scalar-Validierung überprüft (defekte Referenzen schlagen fehl). Swagger 2.0 wird mit einer klaren Botschaft abgelehnt. Maximale Eingabe 512 KiB. Ergebnisbereich zeigt Urteil, Scalar-Issue-Pfade und Spec-Statistiken.

Anwendungsfälle

Erkennen Sie fehlende Informationen, ungültige openapi-Versionen und Schemafehler vor CI. Fügen Sie eine einzelne Dateispezifikation (JSON oder YAML) für eine schnelle lokale Prüfung ein. Bestätigen Sie die Auflösung der internen $ref-Ziele.

Beispiele

Gültige Mindestspezifikation

Vor

{ "openapi": "3.1.0", "info": { "title": "Pets", "version": "1.0.0" }, "paths": { "/pets": { "get": { "operationId": "listPets", "tags": ["pets"], "summary": "List pets", "responses": { "200": { "description": "OK" } } } } } }

Nach

Status: gültig

Swagger 2 abgelehnt

Vor

{"swagger":"2.0","info":{"title":"t","version":"1"},"paths":{}}

Nach

Nicht unterstützt: Swagger 2.0

Validieren Sie die OpenAPI FAQ

Häufige Fragen

Was prüft die Validierung?

Schemakonformität für OpenAPI 3.0–3.2 über @scalar/openapi-Parser. Es handelt sich nicht um einen Style-Linter – verwenden Sie dafür Lint OpenAPI.

Werden $ref unterstützt?

Extern und URL $ref werden nie abgerufen. Interne #/…-Referenzen werden überprüft: Fehlende Ziele schlagen bei der Validierung fehl.

Wird Swagger 2.0 unterstützt?

Nein. Dokumente mit einem Swagger-Schlüssel werden mit einer eindeutigen Nachricht abgelehnt. Diese Seiten erheben keinen Anspruch auf Swagger-Validierung.

JSON und YAML?

Beide. Auto-detect with BOM strip; Wenn ein {…}-Dokument als JSON fehlschlägt, wird ein YAML-Flow-Fallback versucht.

Verwandte Tools?

Siehe auch JSON Validator, Beautify YAML und den API Tools Hub.

OpenAPI Tools zum Formatieren, Validieren und Flusen Ihrer Spezifikationen.