JSON Schema-validator

Wat is een JSON Schema Validator?

// A 5-line schema that catches three real bugs
const schema = {
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id":    { "type": "integer", "minimum": 1 },
    "email": { "type": "string", "format": "email" },
    "age":   { "type": "integer", "minimum": 0, "maximum": 150 }
  },
  "required": ["id", "email"],
  "additionalProperties": false
};

// Three bugs the schema catches:
const bad = { "id": "42", "age": 200 };
//   /id   → type: expected integer, got string
//   /email → required: missing
//   /age   → maximum: 200 > 150

// In Node:        new Ajv().compile(schema)(bad)  // false; ajv.errors has the paths
// In Python:      jsonschema.validate(bad, schema)
// In the browser: this tool — same errors, same paths, no install

Belangrijkste functies

Voorbeelden

{
  "id": 42,
  "email": "alice@example.com",
  "age": 30
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": { "type": "integer", "minimum": 1 },
    "email": { "type": "string", "format": "email" },
    "age": { "type": "integer", "minimum": 0, "maximum": 150 }
  },
  "required": ["id", "email"],
  "additionalProperties": false
}

{
  "id": "42",
  "age": 200
}

{
  "type": "object",
  "properties": {
    "id": { "type": "integer" },
    "email": { "type": "string", "format": "email" },
    "age": { "type": "integer", "maximum": 150 }
  },
  "required": ["id", "email"]
}

{
  "type": "order.created",
  "data": { "orderId": "ORD-001234", "totalUsd": 49.99 }
}

{
  "oneOf": [
    {
      "properties": {
        "type": { "const": "order.created" },
        "data": {
          "type": "object",
          "properties": {
            "orderId": { "type": "string", "pattern": "^ORD-[0-9]{6}$" },
            "totalUsd": { "type": "number", "minimum": 0 }
          },
          "required": ["orderId", "totalUsd"]
        }
      },
      "required": ["type", "data"]
    },
    {
      "properties": {
        "type": { "const": "order.refunded" },
        "data": { "type": "object", "required": ["refundId"] }
      },
      "required": ["type", "data"]
    }
  ]
}

[
  { "sku": "A1", "qty": 3 },
  { "sku": "B2", "qty": 5 },
  { "sku": "A1", "qty": 3 }
]

{
  "type": "array",
  "minItems": 1,
  "uniqueItems": true,
  "items": {
    "type": "object",
    "properties": {
      "sku": { "type": "string", "pattern": "^[A-Z][0-9]+$" },
      "qty": { "type": "integer", "minimum": 1 }
    },
    "required": ["sku", "qty"]
  }
}

Gebruiksaanwijzing

1. 1

   Plak je JSON Schema

   Zet je schema in het rechterpaneel. De validator detecteert de draft automatisch via de $schema-URI als die er is; anders kies je Draft 2020-12, 2019-09 of Draft-07 in de werkbalk.

2. 2

   Plak je JSON-data

   Zet het te controleren JSON-document in het linkerpaneel. Validatie draait terwijl je typt; grote invoer (>200 KB) schakelt over op een handmatige Valideren-knop zodat het tikken vlot blijft.

3. 3

   Lees de foutenlijst

   Elke fout heeft een JSON Pointer-pad, een keyword en een eenregelige boodschap. Klik op een fout om naar de plek in je data te springen, los hem op en zie het aantal real-time dalen.

Veelvoorkomende JSON Schema-valkuilen

{ "qty": 1.0 }   schema: { "type": "integer" }   → error: not an integer

{ "qty": 1 }     schema: { "type": "integer" }   → valid

{ "properties": { "name": { "type": "string", "required": true } } }

{ "properties": { "name": { "type": "string" } }, "required": ["name"] }

{ "properties": { "id": { "type": "integer" } } }   accepts: { "id": 1, "foo": "bar", "x": null }

{ "properties": { "id": { "type": "integer" } }, "additionalProperties": false }

{ "type": "string", "nullable": true }   in 2020-12: nullable is just an unknown keyword

{ "type": ["string", "null"] }   in 2020-12: explicitly allows null

pattern: "[A-Z]+"   accepts: "helloX"   (because X matches)

pattern: "^[A-Z]+$"   accepts only: "HELLO"

oneOf: [ { type: "string" }, { type: "string", maxLength: 10 } ]   on: "hi"   → error: matches both

anyOf: [ { type: "string" }, { type: "string", maxLength: 10 } ]   on: "hi"   → valid

Veelvoorkomende gebruikssituaties

API-requestvalidatie

Plak een request body en het schema van je endpoint vóór de deploy. Vang 400-responses op die je tests niet dekten — ontbrekende required-velden, verkeerde types, getallen buiten bereik.

Webhook-payloadverificatie

Stuurde de leverancier een payload die je handler weigert? Valideer de werkelijke payload tegen je schema, en daarna tegen het gepubliceerde schema van de leverancier. Het verschil tussen die twee is je bug.

Configuratiebestandlinting

package.json, tsconfig.json, helm values.yaml — elk configuratiebestand heeft een publiek schema. Schema plakken, configuratie plakken, typefout vinden. Geen trial-and-error meer.

OpenAPI-componenttest

Til een schemacomponent uit een OpenAPI 3.1-document, plak hem hier en valideer voorbeeldpayloads. Sneller dan een mockserver opspinnen, deterministisch, geen SDK nodig.

Pre-flight voor formulierinzending

Plak een voorbeeld-formulierpayload voor je de frontendvalidatie aansluit. Bevestig dat het schema afwijst wat je verwacht en accepteert wat je verwacht — en lever daarna hetzelfde schema aan client én server.

Datapipelinecontract-controle

ETL-uitvoer gedrift? Plak een voorbeeldrij en het downstream-schema. Zoek uit welke producer veranderde en welke keys braken voordat de pipeline 10.000 records opnieuw probeert.

Technische details

Draft 2020-12-conform

Implementeert de gepubliceerde Draft 2020-12-spec — keywords, typesysteem, format-vocabulaire. Dubbel gecontroleerd tegen Ajv 8.x en de uitvoer van ajv-formats.

JSON Pointer-foutpaden

Fouten gebruiken RFC 6901 JSON Pointer (/user/email/0). Elke keywordfout wijst naar één oplosbare plek in de data — geen ambiguïteit, geen string-search.

Interne $ref-resolutie

Lost $ref-pointers binnen één document op (#/$defs/foo, #/properties/bar). Cycli worden gedetecteerd en gerapporteerd. Externe HTTP $refs uitgeschakeld voor de privacy.

Aanbevolen aanpak

Zet altijd additionalProperties: false

Bij invoercontracten (request bodies, configuratiebestanden, queueberichten) zijn onbekende keys meestal bugs — typefouten, per ongeluk toegevoegde velden of aanvallers die aftasten. Standaard afwijzen.

Gebruik $defs voor herbruikbare subschema's

Inline dezelfde vorm twee keer en ze drijven uit elkaar. Zet gedeelde definities in $defs en refereer met $ref — één bron van waarheid, elke wijziging werkt overal door.

Valideer voor de businesslogica

Voer schemavalidatie meteen na JSON.parse uit, voordat je de geparseerde structuur aanraakt. Type-narrowing, defaults en persistentie gaan er allemaal van uit dat het contract houdt — zorg dat dat zo is.

Veelgestelde vragen