JSON-Schema-Validator

Validieren Sie ein JSON-Dokument gegen ein JSON Schema und sehen Sie genau, wo es fehlschlägt.

Anwendungsbeispiele

Form einer API-Antwort prüfen

Fügen Sie das von Ihrer API versprochene Schema und eine Beispielantwort ein, um vor dem Release zu bestätigen, dass Felder, Typen und Pflichteigenschaften wirklich übereinstimmen.

Fehlerhafte Konfigurationsdatei debuggen

Wenn ein Tool Ihre Konfiguration mit einer vagen Fehlermeldung ablehnt, validieren Sie sie hier gegen das dokumentierte Schema, um genau zu sehen, welches Feld falsch ist und warum.

Datenvertrag eines Pull Requests prüfen

Bevor Sie eine Änderung an einer gemeinsam genutzten JSON-Struktur genehmigen, fügen Sie das aktualisierte Schema und einige Beispieldaten ein, um sicherzustellen, dass nichts still und heimlich kaputtgeht.

Eine Konfigurationsdatei gegen ein dokumentiertes Schema validieren

Viele CLI-Tools veröffentlichen ein JSON Schema für ihre Konfigurationsdatei – fügen Sie Ihre neben dem veröffentlichten Schema ein, um Tippfehler und Typkonflikte vor dem Ausführen des Tools zu finden.

Grenzfälle für ein Schema testen, das Sie gerade schreiben

Fügen Sie beim Entwerfen eines neuen Schemas einige absichtlich ungültige Dokumente ein (mit fehlendem Pflichtfeld, falschem Typ), um zu bestätigen, dass Ihr Schema sie wie erwartet tatsächlich ablehnt.

Häufig gestellte Fragen

Welcher JSON-Schema-Draft wird unterstützt?

Dieses Tool validiert gegen JSON Schema Draft-07, den am weitesten verbreiteten und kompatibelsten Draft. Schlüsselwörter, die erst in späteren Drafts wie 2019-09 oder 2020-12 eingeführt wurden (zum Beispiel '$recursiveRef' oder die neuere Array-Form 'prefixItems'), werden nicht erkannt und möglicherweise stillschweigend ignoriert.

Werden mein Schema oder meine Daten an einen Server gesendet?

Nein. Sowohl das Schema als auch das Dokument werden vollständig in Ihrem Browser mit der Bibliothek ajv validiert. Es wird nichts irgendwohin hochgeladen.

Was ist der Unterschied zwischen 'Ungültiges Schema' und einem Validierungsfehler?

'Ungültiges Schema' bedeutet, dass das JSON Schema selbst fehlerhaft oder widersprüchlich ist und nicht kompiliert werden konnte, sodass die Validierung gar nicht erst ausgeführt werden konnte. Ein Validierungsfehler bedeutet, dass das Schema problemlos kompiliert wurde, Ihr Dokument aber dessen Regeln nicht erfüllt — jede verletzte Regel wird mit dem genauen Pfad in Ihren Daten aufgelistet.

Wie lese ich einen Fehler wie 'bei `/user/age`: must be >= 0'?

Der Pfad zeigt, wo in Ihrem JSON-Dokument das Problem liegt, wobei '/' verschachtelte Schlüssel und Array-Indizes trennt. Die Meldung nach dem Doppelpunkt erklärt, welche Regel des Schemas verletzt wurde.

Kann ein Schema mit $ref auf ein anderes Schema verweisen?

Nur innerhalb desselben eingefügten Dokuments mit lokalen JSON-Pointern desselben Dokuments (wie '#/definitions/address'). Verweise auf externe Dateien oder URLs werden nicht aufgelöst, da nichts aus dem Netzwerk abgerufen wird.

Was erzwingt 'additionalProperties: false' tatsächlich?

Es sorgt dafür, dass das Schema jedes Objekt ablehnt, das nicht ausdrücklich aufgeführte Eigenschaften hat – eine gängige Methode, um Tippfehler bei Feldnamen (etwa 'eamil' statt 'email') zu finden, die sonst unbemerkt durchgehen würden.

Ist ein leeres Schema ({}) gültig?

Ja – ein leeres Schema stellt überhaupt keine Bedingungen, sodass jedes JSON-Dokument dagegen erfolgreich validiert.