Startseite › Entwickler-Tools › JSON Schema Validator

JSON Schema Validator

Füge links ein JSON Schema und rechts deine JSON-Daten ein. Die Validierung läuft während der Eingabe mit der Ajv-Engine, und jeder Fehler zeigt den JSON Pointer, das fehlgeschlagene Schlüsselwort und die Zeile. Klicke auf einen Fehler, um dorthin zu springen.

Zuletzt aktualisiert:

…
Wird validiert…

Anzeige
Anzeige

Anleitung: JSON Schema Validator

  1. Füge dein JSON Schema in den linken Editor ein oder lade eine .json-Schemadatei hoch. Wähle ein Beispiel, um mit einer Vorlage zu starten.
  2. Füge die JSON-Daten, die du prüfen willst, in den rechten Editor ein.
  3. Wähle den Draft oder lass ihn auf Auto, um das Schlüsselwort $schema zu verwenden. Die Validierung läuft während der Eingabe.
  4. Lies das Ergebnis. Grün bedeutet, dass die Daten gültig sind. Andernfalls nennt jeder Fehler den JSON Pointer, die Meldung und das fehlgeschlagene Schema-Schlüsselwort.
  5. Klicke auf einen Fehler, um den fehlerhaften Wert im Daten-Editor zu markieren, korrigiere ihn und sieh zu, wie sich die Liste aktualisiert.

JSON-Schema-Schlüsselwörter auf einen Blick

Ein JSON Schema ist selbst ein JSON-Objekt aus Schlüsselwörtern. Jedes Schlüsselwort fügt eine Regel hinzu, und die Daten sind nur gültig, wenn jede Regel erfüllt ist. Diese Schlüsselwörter wirst du am häufigsten verwenden:

Gilt fürSchlüsselwörterBeispiel
Jeden Werttype, enum und const{"type": ["string", "null"]}
StringsminLength, maxLength, pattern und format{"type": "string", "format": "email"}
Zahlenminimum, maximum, exclusiveMinimum, exclusiveMaximum und multipleOf{"type": "integer", "minimum": 0}
Objekteproperties, required, additionalProperties, patternProperties, propertyNames und minProperties{"required": ["kennung"], "additionalProperties": false}
Arraysitems, prefixItems, minItems, maxItems, uniqueItems und contains{"type": "array", "items": {"type": "string"}}
KombinierenallOf, anyOf, oneOf, not sowie if / then / else{"anyOf": [{"type": "string"}, {"type": "number"}]}
Wiederverwendung$ref, $defs (ab 2019-09), definitions (draft-07), $anchor{"$ref": "#/$defs/adresse"}

Die Fehlerliste lesen

Jeder Fehler besteht aus drei Teilen. Der Pfad ist ein JSON Pointer auf den Wert in deinen Daten, zum Beispiel ist /items/1/price der Preis des zweiten Elements. Das Schlüsselwort ist die Schema-Regel, die fehlgeschlagen ist, etwa required oder pattern. Der Schema-Pfad zeigt auf diese Regel im Schema, etwa #/$defs/item/properties/price/minimum, damit du erkennst, ob die Daten oder das Schema korrigiert werden müssen.

Wenn ein Wert an anyOf oder oneOf scheitert, listet der Validator auf, warum jeder Zweig fehlgeschlagen ist (eingerückt), gefolgt vom zusammenfassenden Fehler. Meist sollte nur ein Zweig zutreffen, also suche nach den Fehlern unter dem Zweig, der deiner Absicht entspricht. Ein gängiger Trick ist, jedem Zweig einen const-Diskriminator hinzuzufügen, etwa "type": {"const": "click"}.

Häufige Fehler in Schemas

  • Tippfehler in Schlüsselwörtern werden stillschweigend ignoriert. "minLenght": 3 oder "require": ["id"] sind unbekannte Schlüsselwörter, daher wird nichts geprüft. Wenn eine Regel scheinbar keine Wirkung hat, prüfe die Schreibweise.
  • required gehört zum Objekt, nicht zur Eigenschaft. Schreibe {"properties": {"id": {...}}, "required": ["id"]}, nicht {"id": {"required": true}} (das war die Syntax von draft-03).
  • additionalProperties: false sieht nicht durch allOf hindurch. In einem anderen Teilschema deklarierte Eigenschaften gelten als zusätzlich. Verwende unevaluatedProperties: false (ab 2019-09), wenn du Schemas kombinierst.
  • items in Array-Form ist nur vor 2020-12 ein Tupel. In 2020-12 verwendest du prefixItems für Positionen und items für den Rest.
  • integer akzeptiert 1.0. JSON Schema vergleicht Zahlen mathematisch, daher ist 1.0 eine gültige Ganzzahl, 1.5 aber nicht.

Häufige Fragen

Was ist ein JSON Schema Validator?

Er prüft, ob ein JSON-Dokument den Regeln eines JSON Schemas entspricht: Pflichteigenschaften, Datentypen, erlaubte Werte, String-Muster, Zahlenbereiche und Array-Längen. Das Ergebnis ist entweder gültig oder eine Liste aller Regeln, gegen die die Daten verstoßen.

Welche JSON-Schema-Drafts werden unterstützt?

Draft-07 (deckt auch die meisten Schemas nach draft-04 und draft-06 ab), Draft 2019-09 und Draft 2020-12. Lass den Draft auf Auto, dann liest der Validator das Schlüsselwort $schema; ein Schema ohne $schema wird als draft-07 behandelt.

Was bedeutet der Fehlerpfad?

Der Pfad ist ein JSON Pointer (RFC 6901) auf den Wert, der fehlgeschlagen ist. /items/2/price bezeichnet die Eigenschaft price des dritten Elements im Array items; ein leerer Pfad steht für den Wurzelwert. Der Schema-Pfad zeigt, welches Schlüsselwort im Schema den Fehler ausgelöst hat.

Werden Formate wie email und date-time geprüft?

Ja, wenn Formate prüfen aktiviert ist. Der Validator versteht date, time, date-time, duration, email, hostname, ipv4, ipv6, uri, uri-reference, uuid, regex und json-pointer. Im JSON-Schema-Standard ist format nur eine Annotation, solange der Validator es nicht ausdrücklich prüft, daher kannst du es ausschalten.

Kann es $ref auf andere Dateien oder URLs auflösen?

Es löst Referenzen innerhalb desselben Schemas auf, etwa #/definitions/address, #/$defs/item, $anchor-Namen und Referenzen auf Basis von $id. Externe Referenzen auf andere Dateien oder URLs werden nicht heruntergeladen, füge diese Definitionen daher zuerst unter $defs ein.

Was ist der Unterschied zwischen draft-07 und 2020-12?

2020-12 hat definitions in $defs umbenannt, items in Array-Form durch prefixItems ersetzt, dependencies in dependentRequired und dependentSchemas aufgeteilt und unevaluatedProperties, unevaluatedItems, minContains und maxContains hinzugefügt. Die meisten dieser Änderungen wurden mit Draft 2019-09 eingeführt.

Werden meine Daten an einen Server gesendet?

Nein. Schema und JSON werden per JavaScript in deinem Browser validiert, sodass private API-Payloads und Konfigurationsdateien nie dein Gerät verlassen.

Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

Ähnliche Tools

Alle Code-Formatierer & Validatoren ansehen →