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.

0 chars · 0 B

Teilen Sie dieses Tool:

OpenAPI Dokument

Ergebnis

OpenAPI 3.x Schemavalidierung über Scalar. Extern / URL $ref werden nie abgerufen; interne #/…-Referenzen werden überprüft. Swagger 2.0 wird nicht unterstützt.

Fügen Sie eine Spezifikation zur Validierung ein

Die Validierung läuft in Ihrem Browser – es wird nichts hochgeladen.

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. • 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.

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"
  },
  „Pfade“: {
    "/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.

Weitere API- und Schema-Tools in diesem Cluster

Formatieren Sie OpenAPIOpenAPI validierenFlusen OpenAPI JSON Schema zu OpenAPI OpenAPI bis JSON Schema JSON Schema-Validator GraphQL validieren

Suchen Sie nach Konvertern, Encodern, Formatierern und Minifiern an einem Ort? Hub für Entwicklertools Öffnen Sie den kuratierten Entwicklertools-Katalog.