
JSON Schema: Daten online validieren (Draft 2020-12)
API-Payloads und Config-Dateien gegen JSON Schema Draft 2020-12 prüfen — Fehler per JSON-Pointer-Pfad, im Browser.
JSON-Daten gegen ein Schema validieren
Gültiges JSON ist nicht dasselbe wie gültig für Ihre API. Ein Payload kann fehlerfrei eingelesen werden und trotzdem ein Pflichtfeld auslassen, den falschen Typ enthalten oder eine format-Bedingung verletzen. Solche Fehler zeigen sich oft erst in Integrationstests oder in den Produktionsprotokollen. JSON Schema beantwortet eine andere Frage als die Syntaxprüfung: Entspricht diese Instanz dem Vertrag? Der Online-JSON-Schema-Validator von FastMinify führt die Validierung nach Draft-07 und 2020-12 in zwei Monaco-Editoren aus (Schema und Instanz), vollständig im Browser. Ist die Syntax fraglich, beginnen Sie mit dem JSON-Validator. Liegt der Vertrag in OpenAPI, nutzen Sie validate-openapi. Der API-Tools-Hub führt die Werkzeuge für Schema-Konvertierung und OpenAPI-Linting auf.
Ehrliche Grenzen und wartbare Schemas
Ein grünes Ergebnis heißt: Die Instanz passt zum eingefügten Schema, nicht dass Ihre gesamte API-Plattform konform ist.
$ref, auch mit https://, werden nie aufgelöstSchemas, die im Browser sauber validieren, überstehen CI und SDK-Generierung besser.
$schema in gemeinsam genutzten Dateien immer, um implizite Annahmen zu 2020-12 zu vermeidenadditionalProperties: false nur bei bewusst geschlossenen Objektenexamples in OpenAPI und fügen Sie sie bei Reviews als Instanzen in den Validator eindescriptionBrowser-Prüfungen sparen Pipeline-Minuten, die Richtlinien der Organisation bleiben in der CI.
JSON-Syntax vs. JSON-Schema-Validierung
Wechseln Sie nicht mitten in der Fehlersuche das Werkzeug: Jedes zielt auf einen anderen Fehlertyp.
FastMinify erkennt den Draft anhand von $schema, sofern vorhanden; ohne $schema gilt 2020-12 als Standard.
https://json-schema.org/draft/2020-12/schemahttp://json-schema.org/draft-07/schema#components.schemasBei einem Fehler zeigt Ajv, wo die Instanz das Schema verletzt, was bei großen API-Payloads unverzichtbar ist.
instancePath zeigt auf den fehlerhaften Wert (JSON-Pointer-Stil)required, type, format, …)required-Schema → Pfad / oder Pfade der fehlenden EigenschaftenJSON Schritt für Schritt gegen ein Schema validieren
Der JSON-Schema-Validator bietet zwei Editoren: Schema und Instanz. Fügen Sie in jedes Feld JSON ein. YAML wird im Schema-Editor nicht akzeptiert, er liest nur JSON. Die Grenze liegt bei 512 KiB pro Feld.
Der Strict-Modus schaltet Ajv strict: true beim Kompilieren des Schemas ein. Unbekannte Schlüsselwörter und andere nicht strikte Muster scheitern dann schon vor der Validierung der Instanz.
components.schemas von OpenAPIDer mobile Client stürzt bei einer neuen Feldform ab. Die Antwort ist gültiges JSON, bricht aber das veröffentlichte Schema.
JSON-Syntax bestätigen
Fügen Sie die Antwort in json-validator ein. Bei einem Syntaxfehler reparieren Sie zuerst.
Schema und Instanz einfügen
Öffnen Sie json-schema-validator. Fügen Sie das kanonische Schema (aus einem OpenAPI-Export oder einer Schema-Registry) und die Staging-Antwort ein.
instancePath-Fehler lesen
Korrigieren Sie die API oder aktualisieren Sie das Schema mit einem Deprecation-Plan. Validieren Sie nach dem Deployment erneut. Optional vergleichen Sie Staging- und Produktions-Payloads mit diff.
Ein Team teilt eine JSON-Konfiguration, die in der CI mit JSON Schema validiert wird. Sie brauchen eine schnelle lokale Prüfung, ohne die Pipeline zu klonen.
Schema aus dem Repository laden
Kopieren Sie das Schema-JSON. Es muss eigenständig sein, denn externe $ref werden im Browser nicht aufgelöst.
Ihre Änderung validieren
Fügen Sie die bearbeitete Konfiguration als Instanz ein. Aktivieren Sie Strict, wenn das Schema für eine strenge Prüfung geschrieben wurde.
Bei Bedarf mit den YAML-Werkzeugen verketten
Konfigurationen liegen oft als YAML vor. Konvertieren Sie sie mit yaml-to-json, prüfen Sie die Syntax und validieren Sie dann die JSON-Instanz gegen das Schema.
OpenAPI, components.schemas und Konvertierung
REST-Teams veröffentlichen ihre Strukturen oft in components.schemas von OpenAPI, während Schema-Registries eigenständige Dateien speichern. Der Validator akzeptiert beides, sobald es als JSON extrahiert ist. Der Ablauf beginnt mit validate-openapi für die Hülle der Spezifikation, extrahiert das Schema und prüft den Payload dann mit json-schema-validator dagegen. Siehe unseren OpenAPI-Validierungsleitfaden und den Lint- & Format-Leitfaden für die Spezifikationsseite des Vertrags.
Ist die OpenAPI-Datei die Quelle des Schemas, wechseln Sie die Formate im Hub ohne lokale CLI. Mit openapi-to-json-schema extrahieren Sie ein Schema aus den OpenAPI-Components. Mit json-schema-to-openapi verpacken Sie ein eigenständiges Schema in eine OpenAPI-Hülle für den Portalimport.
Die Validierung im Browser beschleunigt das Feedback, die Regressionstests bleiben in der CI. Fügen Sie repräsentative Instanzen ein: Normalfall, Null-Grenzfälle und Enum-Grenzen. Dokumentieren Sie den Draft in $schema neben jeder gemeinsam genutzten Schema-Datei in git.
Häufige Validierungsfehler
Diese Fälle tauchen ständig in Support-Tickets und instabilen CI-Jobs auf.
required-Eigenschaft: instancePath zeigt auf das übergeordnete Objekt oder auf die Wurzel /type, etwa ein String, wo eine Ganzzahl erwartet wird (häufig nach der Serialisierung eines Formulars)additionalProperties: false fängt überzählige Felder durch Fehler bei der Versionierung der API abformat-Verletzungen wie date-time, email oder uuid (über ajv-formats)enum durch nicht dokumentierte Status- oder Regionscodes im PayloadStrict-Modus und nicht unterstützte Drafts zeigen sich hier, bevor die Instanz validiert wird.
$schema-URL: auf Draft-07 oder 2020-12 umstellen$ref ist ein harter Fehler: Lösen Sie die Verweise zuerst lokal auf oder bündeln Sie sieZusammenfassung
Die JSON-Schema-Validierung schließt die Lücke zwischen einlesbarem JSON und vertrauenswürdigen API-Daten. Prüfen Sie bei Bedarf zuerst die Syntax. Validieren Sie dann Instanzen gegen Schemas nach Draft-07 oder 2020-12 mit klaren instancePath-Fehlern, lokal vor der CI. Extrahieren Sie Schemas aus OpenAPI, wenn die Verträge in Spezifikationen liegen. Benennen Sie die Grenzen der Browser-Prüfung ehrlich: Referenzen, Drafts und Größe.
JSON-Instanz jetzt gegen Schema validieren
Verwandte Artikel

Fügen Sie Token und JWKS ein und prüfen Sie eine RS256-, ES256- oder HS256-Signatur im Browser. Schlüsselwahl per kid, Fehler und zu prüfende Claims.

HTTP/2 und HTTP/3 ändern den Weg der Dateien, nicht ihre Größe. Messungen zu Größe, Kompilierzeit und Bundling zeigen, was Minifizierung noch bringt.

Rechnen Sie eine Unix-Epoche in ein lesbares Datum um und zurück, unterscheiden Sie Sekunden und Millisekunden und meiden Sie Zeitzonen-, JWT- und Zeitumstellungsfallen.