Hoe JSON Schema te gebruiken om je data te valideren

By Team van JSONValidator.dev • 2025-07-04

Wat is een JSON Schema?

Een JSON Schema is een gestandaardiseerde manier om de structuur, verplichte velden en typen waarden in je JSON-data te beschrijven. Zie het als een contract of blauwdruk voor hoe geldige JSON eruit moet zien. JSON Schema is zelf in JSON geschreven, wat het zowel machineleesbaar als eenvoudig bewerkbaar maakt.

JSON Schema is niet alleen voor validatie—het is ook nuttig voor codegeneratie, API-documentatie en editor-auto-completie.

Waarom valideren met een schema?

  • Voorkom fouten door ongeldige of ontbrekende data te detecteren voordat ze problemen veroorzaken.
  • Waarborg datagegevens consistent blijven tussen teams, apps of API's.
  • Genereer automatisch documentatie vanuit schema's.
  • Help editors en tools betere auto-completie en inline hulp te bieden.
Zelfs een eenvoudig schema kan veelvoorkomende fouten opsporen en daarmee uren debugging besparen.

Een eenvoudig voorbeeld: basis schema

Hier is een basis JSON-object, gevolgd door een minimaal schema dat de structuur valideert:

{
  "name": "Alice",
  "age": 30
}
{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "number" }
  },
  "required": ["name", "age"]
}

Dit schema zorgt ervoor dat het object een 'name' (als string) en een 'age' (als nummer) moet bevatten.

Hoe schrijf je een aangepast schema

Je kunt geavanceerde regels definiëren in je schema: beperk veldwaarden, specificeer geneste objecten of stel minimum/maximum voor getallen in. Hier is een voorbeeld dat een array van producten valideert:

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": { "type": "string" },
      "price": { "type": "number", "minimum": 0 },
      "tags": {
        "type": "array",
        "items": { "type": "string" }
      }
    },
    "required": ["id", "price"]
  }
}
Begin klein: bouw je schema stap voor stap en gebruik online validators om elke stap te controleren.

JSONValidator.dev gebruiken voor schema-validatie

  1. Plak je JSON-data in de hoofd-editor.
  2. Plak je JSON Schema in de schema-editor hieronder.
  3. Klik op Validate JSON Against This Schema.
  4. Bekijk de validatieresultaten, met eventuele fouten gemarkeerd en toegelicht.
Alle validatie vindt plaats in je browser—je data verlaat je apparaat nooit.

Probleemoplossing bij schema-validatiefouten

Veelvoorkomende oorzaken van validatiefouten zijn:

  • Een verplicht veld ontbreekt in je data.
  • Een waarde-type komt niet overeen met het schema (bijv. string versus nummer).
  • Het schema zelf is ongeldig of bevat typfouten.
Controleer foutmeldingen zorgvuldig—ze geven vaak het exacte veld en type-ongelijkheid aan.

Conclusie

JSON Schema validatie is een krachtige methode om je data robuust en foutbestendig te maken. Probeer zelf een schema te maken met onze gratis JSON Schema Generator en valideer het direct!