Was macht "format": "email" wirklich?

Ein **Hinweis an den Validator**, dass ein String eine Mail sein soll (z.B. `user@example.com`). Ein Validator wie `ajv` mit `ajv-formats` prueft den Wert per Regex. JSON Schema selbst **erzwingt keine** Format-Validierung - optional, aber stark empfohlen fuer User-Eingaben.

Warum ist integer ein eigener Typ neben number?

JSON Schema unterscheidet **ganze Zahlen** (`integer`) von **beliebigen Zahlen** (`number`, inkl. Floats). Ein "age"-Feld ist Integer (47, nicht 47.5), ein "score"-Feld kann Float sein (91.4). So lehnt der Validator "age: 47.5" ab.

Was bedeutet "additionalProperties: false"?

**Strict-Modus**: der Validator lehnt Objekte mit **Extra-Feldern** ab, die nicht in `properties` stehen. Sehr nuetzlich fuer APIs - du willst nicht, dass ein Client `{name, age, secretAdmin: true}` schickt und keiner merkt es. Ohne (`additionalProperties: true`, Default) werden Extras still ignoriert.

Wie werden Enums erkannt?

Wir schauen auf **String-Felder in Arrays von Objekten**. Erscheint derselbe Key in jedem Element, ist String-typisiert, und die **Anzahl unterschiedlicher Werte ist klein** (bis 8) und kleiner als die Anzahl Elemente - geben wir `enum: ["a", "b", "c"]` aus. In den Settings ausschaltbar.

Warum sind null-Felder als required markiert?

Per Default markieren wir jedes im Sample vorhandene Feld als **required** - ein Feld mit Wert `null` ist immer noch da, hat nur Typ `null`. **API-Konvention**: "dieses Feld muss existieren, kann null sein, aber **darf nicht fehlen**". Willst du das Gegenteil (alles optional), schalt "alles required" aus.

Wie funktioniert Tuple-Erkennung (prefixItems)?

Ein Array wie `["lat", 51.5074, true]` ist ein **positionales Tuple**: Index 0 = string, 1 = number, 2 = boolean. Kein homogenes Array. Der Generator sieht den Typ-Mismatch und gibt `prefixItems: [{type:"string"}, {type:"number"}, {type:"boolean"}]` aus. Arrays, wo jedes Element den gleichen Typ hat (z.B. alle Strings), bleiben Plain Arrays mit `items`.

Was, wenn ich nur ein Objekt in einem Array habe?

Aus einem einzelnen Sample abzuleiten hat Grenzen: wir koennen nicht sagen, **welche Felder optional** vs. immer da sind. Wir nehmen alles als required an. Gib dem Algorithmus **mehrere Objekte** im Array (mit verschiedenen Feld-Sets), und er markiert nur die als required, die in jedem Sample sind.

Warum JSON-Output und kein YAML?

JSON Schema ist per Definition ein JSON-Dokument. Brauchst du YAML (z.B. fuer OpenAPI), ist das eine **triviale Konvertierung** mit `js-yaml`. Die JSON-Form ist das kanonische Austauschformat zwischen Libraries und Editoren.

Wie nutze ich das Schema im Code?

In **Node.js/TypeScript** ist `ajv` der beliebteste Validator: `const validate = ajv.compile(schema); if (!validate(data)) console.log(validate.errors);`. Andere Sprachen: Python (`jsonschema`), Java (`networknt/json-schema-validator`), Go (`santhosh-tekuri/jsonschema`). Schema mit ins Repo und jeden Payload validieren.

JSON Schema aus JSON

JSON einfügen, fertiges JSON Schema bekommen (Draft 2020-12, 2019-09, 7) - mit Types, Formats und Enums.

LiveLäuft im Browser

JSON-Schema-Draft

Generator-Optionen

Strict-ModusAn: additionalProperties: false überall. Aus: nur am Root-Objekt.String-Formate erkennenEmail, date-time, date, uuid, ipv4, ipv6, uri, hostname - fügt `"format": "..."` hinzu.Enums erkennenStrings in einem Array-of-Objects mit ≤8 distinkten Werten werden als `enum` ausgegeben.Alle Felder erforderlichAn: jedes Feld im Sample ist erforderlich. Aus: nur Felder, die in jedem Array-Element vorkommen.

Titel (optional)Beschreibung (optional)

Beispiel-JSON

Generiertes JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "email": {
      "type": "string",
      "format": "email"
    },
    "createdAt": {
      "type": "string",
      "format": "date-time"
    },
    "active": {
      "type": "boolean"
    },
    "loginCount": {
      "type": "integer"
    },
    "score": {
      "type": "number"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "address": {
      "type": "object",
      "properties": {
        "street": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "zip": {
          "type": "string"
        },
        "country": {
          "type": "string"
        }
      },
      "required": [
        "city",
        "country",
        "street",
        "zip"
      ]
    },
    "addressList": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string"
          },
          "city": {
            "type": "string",
            "enum": [
              "London",
              "Cambridge"
            ]
          },
          "primary": {
            "type": "boolean"
          }
        },
        "required": [
          "city",
          "label",
          "primary"
        ]
      }
    },
    "coordinates": {
      "type": "array",
      "prefixItems": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        }
      ]
    },
    "website": {
      "type": "string",
      "format": "uri"
    },
    "lastLoginIp": {
      "type": "string",
      "format": "ipv4"
    },
    "deletedAt": {
      "type": "null"
    }
  },
  "required": [
    "active",
    "address",
    "addressList",
    "coordinates",
    "createdAt",
    "deletedAt",
    "email",
    "id",
    "lastLoginIp",
    "loginCount",
    "score",
    "tags",
    "website"
  ],
  "additionalProperties": true
}

Eigenschaften

Pflicht

Formate

JSON-Schema-Generator aus Beispiel-JSON

JSON Schema ist das "Handbuch" fuer dein JSON: welche Felder Pflicht sind, welche Typen, welche Formate. Paste ein Beispiel-JSON, wir leiten das Schema fuer dich ab.

Wir erkennen Typen (string, integer, number, boolean, null, array, object), String-Formate (email, date-time, uuid, ipv4, uri), homogene Arrays vs. Tuples] mit prefixItems, und kurze Enums fuer Felder mit begrenzter Wertemenge.

Waehl einen Draft (Draft 2020-12, 2019-09 oder den aelteren Draft 7) und einen Strictness-Modus: strict (additionalProperties: false, alles required) oder tolerant (Extra-Felder erlaubt).

So nutzt du das Tool

Waehl den JSON-Schema-Draft oben (Draft 2020-12 ist der sichere Default).
Paste ein Beispiel-JSON ins linke Panel. Je mehr Objekte du in einem Array hast, desto besser koennen wir sagen "welche Felder Pflicht sind".
Aktivier Format-Erkennung, damit "2026-05-13" `"format": "date"` und "user@example.com" `"format": "email"` bekommt.
Strict-Modus erzwingt `additionalProperties: false` und markiert jedes Property als required. Tolerant erlaubt Extra-Keys.
Kopier das generierte Schema rechts und kipp es als `schema.json` in dein Projekt, fertig fuer Validierung.

Wann das nuetzlich ist

Echte Situationen beim Arbeiten mit APIs und Daten:

API-Dokumentation - du hast eine Beispiel-Response und brauchst ein formales Schema fuer OpenAPI oder interne Doku. JSON pasten, Schema in 2 Sekunden.
Input-Validierung - einen POST-Endpoint vor fehlenden Pflichtfeldern schuetzen. Schema plus ajv-Library im Backend = Sicherheit.
TypeScript-Typ-Generierung - JSON Schema fuettert Tools wie `json-schema-to-typescript`. Aus JSON Schema, aus Schema Interface.
Tool-Konfiguration - VSCode `settings.json`, ESLint-Config, package.json nutzen alle Schemas. Schreib dein eigenes, kriegst Autocomplete im Editor.
Contract-Tests - leg das Schema des letzten Releases ins Source Control und validier das neue gegen es, fuer Backwards-Compatibility.
Form-Generierung - manche Libraries (react-jsonschema-form) rendern Formulare direkt aus JSON Schema. Damit das Schema bootstrappen, dann tweaken.

Um JSON gegen ein Schema zu validieren, nimm den JSON-Schema-Validator. Um TypeScript-Typen aus JSON zu generieren, schau JSON zu TypeScript. Fuer Daten-Struktur-Exploration den JSONPath-Tester.

Fragen und Antworten

Aufeinanderfolgende Editionen des JSON-Schema-Standards. Neueste: 2020-12 (z.B. `prefixItems` statt `items: []` fuer Tuples, `$dynamicRef`). Draft 2019-09 brachte `unevaluatedProperties` und ordnete viele Keywords um. Draft 7 ist immer noch am haeufigsten in Libraries. Im Zweifel: 2020-12.

Das könnte auch passen

Passende Tools

JSON-Schema-Validator

Schema und JSON einfügen, Fehlerliste mit genauen Pfaden und klaren Erklärungen bekommen.

JSON-Formatter

JSON formatieren, minifizieren und validieren - mit Zeile und Spalte bei Fehlern. Plus Statistiken: Tiefe, Anzahl Keys, Typen-Verteilung.

JSON zu TypeScript

Beispiel-JSON einfügen, sauberes TypeScript-Interface oder Type bekommen. Oder ein Zod-Schema. Oder ein JSON-Schema.

JSONPath-Tester

JSON einfügen, JSONPath-Ausdruck eintippen ($.store.book[*].author), gematchte Elemente live sehen. Mit fertigen Beispielen und Spickzettel.

{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "email": { "type": "string", "format": "email" }, "createdAt": { "type": "string", "format": "date-time" }, "active": { "type": "boolean" }, "loginCount": { "type": "integer" }, "score": { "type": "number" }, "tags": { "type": "array", "items": { "type": "string" } }, "address": { "type": "object", "properties": { "street": { "type": "string" }, "city": { "type": "string" }, "zip": { "type": "string" }, "country": { "type": "string" } }, "required": [ "city", "country", "street", "zip" ] }, "addressList": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "city": { "type": "string", "enum": [ "London", "Cambridge" ] }, "primary": { "type": "boolean" } }, "required": [ "city", "label", "primary" ] } }, "coordinates": { "type": "array", "prefixItems": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "website": { "type": "string", "format": "uri" }, "lastLoginIp": { "type": "string", "format": "ipv4" }, "deletedAt": { "type": "null" } }, "required": [ "active", "address", "addressList", "coordinates", "createdAt", "deletedAt", "email", "id", "lastLoginIp", "loginCount", "score", "tags", "website" ], "additionalProperties": true }

JSON-Schema-Generator aus Beispiel-JSON

JSON Schema ist das "Handbuch" fuer dein JSON: welche Felder Pflicht sind, welche Typen, welche Formate. Paste ein Beispiel-JSON, wir leiten das Schema fuer dich ab.

Waehl einen Draft (Draft 2020-12, 2019-09 oder den aelteren Draft 7) und einen Strictness-Modus: strict (additionalProperties: false, alles required) oder tolerant (Extra-Felder erlaubt).

So nutzt du das Tool

Waehl den JSON-Schema-Draft oben (Draft 2020-12 ist der sichere Default).

Paste ein Beispiel-JSON ins linke Panel. Je mehr Objekte du in einem Array hast, desto besser koennen wir sagen "welche Felder Pflicht sind".

Aktivier Format-Erkennung, damit "2026-05-13" `"format": "date"` und "user@example.com" `"format": "email"` bekommt.

Strict-Modus erzwingt `additionalProperties: false` und markiert jedes Property als required. Tolerant erlaubt Extra-Keys.

Kopier das generierte Schema rechts und kipp es als `schema.json` in dein Projekt, fertig fuer Validierung.

Wann das nuetzlich ist

Echte Situationen beim Arbeiten mit APIs und Daten:

API-Dokumentation - du hast eine Beispiel-Response und brauchst ein formales Schema fuer OpenAPI oder interne Doku. JSON pasten, Schema in 2 Sekunden.
Input-Validierung - einen POST-Endpoint vor fehlenden Pflichtfeldern schuetzen. Schema plus ajv-Library im Backend = Sicherheit.
TypeScript-Typ-Generierung - JSON Schema fuettert Tools wie `json-schema-to-typescript`. Aus JSON Schema, aus Schema Interface.
Tool-Konfiguration - VSCode `settings.json`, ESLint-Config, package.json nutzen alle Schemas. Schreib dein eigenes, kriegst Autocomplete im Editor.
Contract-Tests - leg das Schema des letzten Releases ins Source Control und validier das neue gegen es, fuer Backwards-Compatibility.
Form-Generierung - manche Libraries (react-jsonschema-form) rendern Formulare direkt aus JSON Schema. Damit das Schema bootstrappen, dann tweaken.

Fragen und Antworten