JSON-Schema-Validator

Der JSON-Schema-Validator prüft JSON-Daten gegen ein JSON Schema nach Draft 2020-12 oder Draft-07 und zeigt jede Abweichung mit Pfad und verletzter Regel.

JSON-Schema
JSON-Daten
–

 

PfadFehlerSchema-Stelle

Alles läuft in Ihrem Browser. Eingaben verlassen Ihr Gerät nicht.

JSON gegen ein Schema prüfen

Ein JSON Schema beschreibt, wie gültige JSON-Daten aussehen: welche Felder Pflicht sind, welche Typen erlaubt sind, wie lang Texte sein dürfen und welche Werte zulässig sind. Der JSON-Schema-Validator prüft Ihre Daten gegen ein solches Schema und listet jede Abweichung mit Pfad auf, etwa $.adresse.plz, dazu die Stelle im Schema. So können Sie JSON validieren, bevor Sie es an eine API schicken oder in einer Konfiguration einsetzen.

Unterstützt werden die wichtigsten Schlüsselwörter von Draft 2020-12 und Draft-07: type, enum, const, properties, required, additionalProperties, patternProperties, items, prefixItems, minItems und maxItems, uniqueItems, contains, minimum und maximum samt exklusiver Grenzen, multipleOf, minLength und maxLength, pattern, anyOf, oneOf, allOf, not, if/then/else, dependentRequired sowie lokale Verweise mit $ref auf #/$defs oder #/definitions. Die Version wird aus $schema erkannt.

Das JSON-Schema-Beispiel beim Laden zeigt typische Fehler: falscher Typ, Pflichtfeld fehlt, Wert außerhalb der erlaubten Liste, Muster passt nicht, zusätzliches Feld. Grenzen: Verweise auf externe Dateien oder URLs, unevaluatedProperties und dynamische Anker ($dynamicRef) werden nicht ausgewertet. Formatprüfungen wie email sind eine Annäherung an die Spezifikation. Wer ein JSON Schema prüfen lassen will, das in Produktion genutzt wird, sollte zusätzlich die Bibliothek der eigenen Programmiersprache verwenden, etwa Ajv oder jsonschema.

Anleitung: JSON Schema Validator in 4 Schritten

  1. Das JSON-Schema in das linke Feld einfügen oder mit „Beispiel“ ein Muster laden.
  2. Die zu prüfenden JSON-Daten in das Feld „JSON-Daten“ einfügen.
  3. Die Schema-Version auf „Automatisch ($schema)“ lassen oder fest Draft 2020-12 oder Draft-07 wählen.
  4. Bei Bedarf „Formate prüfen (email, date, uri …)“ einschalten und die Fehlerliste mit Pfad, Fehler und Schema-Stelle durchgehen.

Typische Anwendungsfälle

  • API-Anfragen vor dem Senden gegen das Schema der Schnittstelle prüfen.
  • Strukturierte Ausgaben eines KI-Modells kontrollieren, das JSON nach einem vorgegebenen Schema liefern soll.
  • Konfigurationsdateien validieren, bevor sie in einer Anwendung oder Pipeline eingesetzt werden.
  • Ein neues Schema mit Testdaten ausprobieren, um zu sehen, ob required, enum und pattern wie gewünscht greifen.
Fragen

Häufige Fragen

Welche Schema-Versionen werden unterstützt?

Der Kern von Draft 2020-12 und Draft-07; Schemas nach Draft-04 und -06 funktionieren in den meisten Fällen ebenfalls. Die Version wird aus $schema gelesen oder kann fest eingestellt werden.

Wird das Feld format immer geprüft?

Nach der Spezifikation ist format standardmäßig nur eine Anmerkung. Viele Validatoren prüfen es trotzdem; hier lässt sich die Prüfung ein- und ausschalten.

Kann ich $ref auf andere Dateien verwenden?

Nein, nur Verweise innerhalb des Schemas, zum Beispiel #/$defs/adresse. Externe Dateien würden eine Netzwerkanfrage erfordern.

Was bedeutet der Pfad $.tags[1]?

Er zeigt auf das zweite Element (Zählung ab 0) der Liste tags im obersten Objekt. So finden Sie die fehlerhafte Stelle in großen Dokumenten schnell.

Wie erstelle ich ein JSON Schema aus vorhandenen Daten?

Mit einem Schema-Generator, der aus einem JSON-Beispiel Typen und Felder ableitet. Das Ergebnis ist ein Ausgangspunkt: Pflichtfelder, erlaubte Werte und Muster ergänzen Sie anschließend von Hand und prüfen sie hier.

Was bedeutet additionalProperties: false?

Das Objekt darf nur die Felder enthalten, die unter properties (oder patternProperties) beschrieben sind. Jedes zusätzliche Feld meldet der Validator als Fehler, was Tippfehler in Feldnamen schnell sichtbar macht.

Weitere Werkzeuge

Das könnte auch helfen

Alle 358 Werkzeuge