JSON Schema
Definition
JSON Schema ist ein JSON-basiertes Format zur Beschreibung der Struktur von JSON-Daten (Medientyp application/schema+json).
Die Spezifikation besteht aus den Teilen Core und Validation: Core legt die Grundlagen fest, Validation definiert die Validierungsschlüsselwörter. Mit diesen Schlüsselwörtern lassen sich Anforderungen an ein JSON-Dokument stellen, etwa zum Typ („type“), zu Pflichteigenschaften („required“) oder zu Ober- und Untergrenzen von Zahlen („maximum“, „minimum“).
Einfach erklärt
Ein Bauplan legt fest, welche Datenfelder erlaubt und erforderlich sind; ob die eingetragenen Angaben fachlich stimmen, prüft er nicht.
Warum das im Alltag wichtig ist
JSON Schema macht Datenstrukturen zwischen Systemen prüfbar. Auch bei KI-Ausgaben können Pflichtfelder und Formate kontrolliert werden, bevor ein weiterer Arbeitsschritt beginnt.
Beispiel aus dem Mittelstand
Mögliches Beispiel: Ein Agent darf nur ein JSON-Objekt mit order_id, status und confidence erzeugen; das Ergebnis wird vor dem nächsten Workflow-Schritt gegen das Schema validiert.
Grenzen und Fallstricke
- Eine gültige Struktur garantiert keine fachlich richtigen Werte. Versionen und Dialekte müssen zusammenpassen; ohne ausdrückliche Pflichtfeldangabe verlangt „required“ keine Eigenschaften.
Entstehung & Geschichte
JSON Schema wurde über mehrere Drafts entwickelt, darunter Draft-04, Draft-06 und Draft-07; darauf folgten die Versionen 2019-09 und 2020-12. Die ausgewerteten Fassungen von Core und Validation sind Internet-Drafts der Version 2020-12 vom 16. Juni 2022.
Anwendung im Mittelstand
- Mögliche Einsatzfelder: Datenverträge zwischen Systemen und Schnittstellen beschreiben (OpenAPI baut für Datentypen auf JSON Schema auf); Konfigurationsdateien auf ihre Struktur prüfen; Eingaben aus Importen vor der Weiterverarbeitung auf Pflichtfelder prüfen.
Häufige Fragen
Ist JSON Schema dasselbe wie OpenAPI?
Nein. In OpenAPI 3.1.0 ist das Schema Object eine Obermenge von JSON Schema Draft 2020-12; OpenAPI beschreibt darüber hinaus eine Schnittstelle zu HTTP-APIs.
Können Schemas selbst validiert werden?
Ja, über Meta-Schemas; das JSON-Schema-Meta-Schema validiert sich selbst.
Wofür ist das Schlüsselwort „format“ gedacht?
Es ist eine Annotation, mit der Schema-Autoren semantische Informationen zu bestimmten Werten mitgeben.
Quellen
- JSON Schema: A Media Type for Describing JSON Documents · Wright et al. (2022): JSON Schema: A Media Type for Describing JSON Documents
- JSON Schema Validation: A Vocabulary for Structural Validation of JSON · Wright et al. (2022): JSON Schema Validation: A Vocabulary for Structural Validation of JSON
- OpenAPI Specification v3.1.0 · OpenAPI Initiative (2021): OpenAPI Specification v3.1.0
- JSON Schema - Specification · JSON Schema (o. J.): JSON Schema - Specification
Quellen geprüft am 14.10.2026. Redaktionelle Anwendungsbeispiele sind hypothetisch; kein Nachweis realer Kundenergebnisse.
Redaktionell geprüft am: