JSON-Schema-Validator

Dieses Tool unterstützt JSON-Schema Draft-07, Draft 2019-09 und Draft 2020-12 über die Ajv-Bibliothek. Die meisten gängigen Schema-Funktionen werden unterstützt.

Ja! JSON-Schema unterstützt tief verschachtelte Objekte und Arrays. Sie können Eigenschaften und Elemente auf jeder Verschachtelungsebene mit individuellen Validierungsregeln für jedes Feld definieren.

Das Tool validiert zuerst, dass Ihr Schema selbst gültiges JSON-Schema ist. Wenn das Schema Fehler aufweist, werden diese gemeldet, bevor die Daten validiert werden.

type (string, number, object, array, boolean, null), properties mit verschachtelten Schemata, required mit den Pflichtschlüsseln, enum für feste Wertmengen, pattern für Regex-beschränkte Zeichenketten sowie die Bereichsprüfungen minimum/maximum und minLength/maxLength. additionalProperties: false schränkt Objekte gegenüber zusätzlichen Schlüsseln ein. Zusammen decken sie den Großteil der API-Validierungsregeln ab.

Im modernen JSON Schema ist format standardmäßig eine Annotation und keine automatische Assertion - Validatoren erzwingen sie nur, wenn sie entsprechend konfiguriert sind, was die 2020-12-Spezifikation mit einem separaten format-assertion-Vokabular explizit festgelegt hat. Muss die Erzwingung garantiert sein, verwenden Sie pattern oder ein eigenes Schlüsselwort; andernfalls behandeln Sie format als Metadaten für Interoperabilität.

Ein $ref, der auf #/$defs/address zeigt, referenziert ein Schema-Fragment unter $defs und validiert an jeder Verwendungsstelle dagegen - der Mechanismus zur Deduplizierung. Draft 2020-12 benannte das ältere definitions in $defs um und formalisierte $dynamicRef für rekursive Strukturen wie Kommentarbäume. Referenzen können auch auf externe Dokumente verweisen, wobei lokales Bundling üblicher ist.

allOf verlangt, dass jedes Subschema validiert - eine Schnittmenge, mit der sich ein Basisschema um zusätzliche Einschränkungen erweitern lässt. anyOf verlangt mindestens eines - eine Vereinigung, üblich für polymorphe Payloads. oneOf verlangt genau eines; die Validierung von zwei oder null Subschemata schlägt fehl, was strenger ist, als die meisten erwarten, und die übliche Ursache für überraschende Fehler bei überlappenden Schemata.

2020-12 teilte die Spezifikation in separat aushandelbare Vokabulare auf (validation, annotation, format-assertion), benannte definitions in $defs um, vereinfachte exclusiveMinimum zu einer reinen Zahl und ersetzte das ältere Schlüsselwort items durch prefixItems plus items. Die meisten Tools unterstützen beides; draft-07 ist weiterhin am weitesten verbreitet, aber 2020-12 ist der aktuell veröffentlichte Standard.