Wichtigste Erkenntnisse
- 01Powered by Ajv, dem am weitesten verbreiteten JavaScript-JSON-Schema-Validator — was hier bestanden wird, besteht auch in Node.js, Fastify und den meisten JS-Toolchains.
- 02Meldet jeden Validierungsfehler auf einmal (allErrors-Modus), nicht nur den ersten Fehler.
- 03Jeder Fehler enthält den JSON-Pointer-Pfad zum fehlgeschlagenen Feld für schnelle Navigation.
- 04Sowohl Schema als auch Daten werden vollständig in Ihrem Browser ausgeführt — nichts wird hochgeladen.
Warum JSON gegen ein Schema validieren?
JSON Schema ist die Standardmethode, um die Struktur eines JSON-Dokuments zu beschreiben — erforderliche Felder, zulässige Typen, Wertbeschränkungen, verschachtelte Objektstrukturen. Die Validierung gegen ein Schema, bevor eine Payload in die Produktion geht, erkennt Typfehler, fehlende erforderliche Felder und Verletzungen von Einschränkungen frühzeitig, wenn sie noch günstig zu beheben sind.
Die häufigsten Anwendungsfälle sind das Testen von API-Request- und Response-Bodies, das Validieren von Konfigurationsdateien, das Überprüfen von OpenAPI-Beispielobjekten und das Überprüfen von Datenexporten gegen eine bekannte Struktur. Der Validator von Handytool verwendet Ajv — die De-facto-JavaScript-JSON-Schema-Bibliothek, die in Node.js selbst verwendet wird — sodass die Ergebnisse hier mit dem übereinstimmen, was Ihr Backend sieht.
So validieren Sie JSON gegen ein Schema
- 01
Fügen Sie Ihr JSON-Schema ein
Fügen Sie das Schema im linken Bereich ein. Dies kann ein Draft-7-, 2019-09- oder 2020-12-Schema mit type, properties, required, items, anyOf, allOf — beliebigen von Ajv unterstützten Standard-Keywords sein.
- 02
Fügen Sie Ihre JSON-Daten ein
Fügen Sie das Datendokument, das Sie validieren möchten, im rechten Bereich ein. Dies ist die Instanz — ein API-Request-Body, ein Config-Objekt, ein Export-Datensatz oder ein einzelnes Beispiel aus Ihrer OpenAPI-Spezifikation.
- 03
Klicken Sie auf Validieren
Ajv führt die Validierung mit allErrors: true aus, was bedeutet, dass es jeden Fehler sammelt, anstatt beim ersten zu stoppen.
- 04
Überprüfen Sie die Fehlerliste
Jeder Fehler zeigt den JSON-Pointer-Pfad zum fehlgeschlagenen Wert (z. B. /user/email), das fehlgeschlagene Keyword (type, required, minimum) und eine benutzerfreundliche Meldung. Beheben Sie jeden Fehler und validieren Sie erneut.
Was Entwickler mit JSON Schema validieren
- 01REST-API-Request-Bodies — bestätigen Sie, dass eine Payload der erwarteten Form des Endpunkts entspricht, bevor Sie sie senden.
- 02OpenAPI-Spec-Beispielobjekte — validieren Sie jedes Beispiel gegen die Inline-Schema-Komponente.
- 03Konfigurationsdateien — stellen Sie sicher, dass erforderliche Schlüssel vorhanden sind und Werte den richtigen Typ haben.
- 04Datenpipeline-Datensätze — erkennen Sie strukturelle Abweichungen zwischen Datenproduzenten und -konsumenten.
- 05Form-Submission-Payloads — testen Sie, dass die Frontend-Validierung die Backend-Schema-Einschränkungen widerspiegelt.
- 06Webhook-Bodies von Drittanbietern — bestätigen Sie, dass das dokumentierte Schema der tatsächlichen Payload entspricht.
Private Validierung ohne Server erforderlich
Ajv wird vollständig in Ihrem Browser ausgeführt. Weder das Schema noch die Daten werden an einen Server gesendet — Sie können Schemas, die interne Datenstrukturen beschreiben, und Datenobjekte, die vertrauliche Feldwerte enthalten, sicher validieren.
Der Validator unterstützt JSON-Schema-Drafts 6, 7, 2019-09 und 2020-12. Der am häufigsten verwendete Draft ist Draft 7, der alle alltäglichen Keywords abdeckt: type, properties, required, items, minimum, maximum, pattern, enum, anyOf, allOf, oneOf, not und $ref.
JSON-Schema-Validator – Häufig gestellte Fragen
Welche JSON-Schema-Drafts werden unterstützt?
Ajv unterstützt die Drafts 6, 7, 2019-09 und 2020-12. Draft 7 ist der häufigste in bestehenden Codebasen und deckt alle Standard-Keywords ab.
Warum wird mein $ref-Schema nicht aufgelöst?
Externe $ref-URLs werden in diesem reinen Browser-Tool nicht abgerufen. Integrieren Sie alle referenzierten Schemas mit $defs und lokalen JSON-Pointern wie #/$defs/MyType.
Werden mein Schema oder meine Daten auf einen Server hochgeladen?
Nein. Ajv wird vollständig in Ihrem Browser ausgeführt — sowohl Schema als auch Daten bleiben auf Ihrem Gerät.
Kann ich dies verwenden, um eine OpenAPI-3-Spezifikation zu validieren?
Sie können einzelne Schema-Komponenten und Beispielobjekte validieren. Die Validierung des gesamten OpenAPI-Dokuments erfordert einen dedizierten OpenAPI-Validator, der das Spec-Meta-Schema versteht.
Warum sehe ich mehrere Fehler statt nur den ersten?
Der Validator ist mit allErrors: true konfiguriert, was Ajv veranlasst, jeden Fehler zu sammeln, anstatt beim ersten zu stoppen. Dies ist beabsichtigt — Sie können alle Probleme in einem Durchgang beheben, anstatt wiederholte Validierungsversuche zu unternehmen.