Zum Inhalt springen

JSON Schema

JSON Schema beschreibt Struktur und Einschränkungen von JSON-Daten. Ein Validator prüft diese Regeln; ihre Einhaltung beweist noch keine fachliche Richtigkeit.

API und Datenverträge

JSON Schema ist eine Sprache, mit der sich Struktur und Einschränkungen von JSON-Daten beschreiben lassen. Dazu gehören Datentypen und Regeln für Eigenschaften. Ein Validator kann prüfen, ob konkrete Daten dem vorgegebenen Schema entsprechen.

Gültige JSON-Syntax und passende Daten unterscheiden

Im fiktiven Auftragseingang muss das Feld quantity eine ganze Zahl enthalten. Der Zahlenwert 2 und die Zeichenfolge "2" sind unterschiedliche Wertearten. Ein syntaktisch gültiges JSON-Dokument erfüllt deshalb nicht automatisch die vereinbarte Feldregel.

Pflichtfelder ausdrücklich festlegen

Die JSON-Schema-Dokumentation erläutert, dass aufgeführte Eigenschaften nicht automatisch Pflichtfelder sind. Erforderliche Angaben müssen im Schema entsprechend festgelegt werden. Die Übersicht beschreibt die Prüfung durch einen Validator. Selbst ein bestandener Schematest bestätigt jedoch nicht, dass die Menge zur richtigen Bestellung gehört oder im ERP verarbeitet wurde. Strukturprüfung, fachliche Zuordnung und erfolgreiche Verarbeitung brauchen jeweils einen passenden Nachweis.

Quellen