Belangrijkste punten
- 01Aangedreven door Ajv, de meest gebruikte JavaScript JSON Schema validator — wat hier slaagt, slaagt ook in Node.js, Fastify en de meeste JS-toolchains.
- 02Rapporteert elke validatiefout tegelijk (allErrors-modus), niet alleen de eerste fout.
- 03Elke fout bevat het JSON Pointer-pad naar het falende veld voor snelle navigatie.
- 04Zowel schema als gegevens worden volledig in uw browser uitgevoerd — niets wordt geüpload.
Waarom JSON tegen een Schema valideren?
JSON Schema is de standaardmanier om de structuur van een JSON-document te beschrijven — verplichte velden, toegestane typen, waardebeperking, geneste objectstructuren. Validatie tegen een schema voordat een payload productie bereikt, vangt type-mismatch, ontbrekende verplichte velden en schendingen van beperkingen vroeg op, wanneer ze goedkoop zijn om op te lossen.
De meest voorkomende use cases zijn het testen van API-request- en response-bodies, het valideren van configuratiebestanden, het controleren van OpenAPI-voorbeeldobjecten en het verifiëren van gegevensexports tegen een bekende structuur. Handytool's validator gebruikt Ajv — de de-facto JavaScript JSON Schema-bibliotheek, gebruikt in Node.js zelf — dus de resultaten hier komen overeen met wat uw backend zal zien.
JSON tegen een Schema valideren
- 01
Plak uw JSON Schema
Plak het schema in het linkervenster. Dit kan een Draft 7, 2019-09 of 2020-12 schema zijn met type, properties, required, items, anyOf, allOf — elk standaard Ajv-ondersteund sleutelwoord.
- 02
Plak uw JSON-gegevens
Plak het gegevensdocument dat u wilt valideren in het rechtervenster. Dit is de instantie — een API-requestbody, een configuratieobject, een exportrecord of een enkel voorbeeld uit uw OpenAPI-spec.
- 03
Klik op Valideren
Ajv voert de validatie uit met allErrors: true, wat betekent dat het elke fout verzamelt in plaats van bij de eerste te stoppen.
- 04
Bekijk de foutlijst
Elke fout toont het JSON Pointer-pad naar de falende waarde (bijv. /user/email), het falende sleutelwoord (type, required, minimum) en een leesbaar bericht. Corrigeer elk en valideer opnieuw.
Wat ontwikkelaars valideren met JSON Schema
- 01REST API-requestbodies — bevestig dat een payload overeenkomt met de verwachte vorm van het eindpunt voordat u deze verzendt.
- 02OpenAPI spec-voorbeeldobjecten — valideer elk voorbeeld tegen de inline schemacomponent.
- 03Configuratiebestanden — zorg ervoor dat verplichte sleutels aanwezig zijn en waarden het juiste type hebben.
- 04Gegevenspijplijnrecords — spot structurele drift tussen gegevensproducenten en consumenten.
- 05Formulierinzendingsgegevens — test dat frontend-validatie backend-schemabeperking weerspiegelt.
- 06Webhook-bodies van derden — bevestig dat het gedocumenteerde schema overeenkomt met de werkelijke payload.
Privévalidatie, geen server vereist
Ajv wordt volledig in uw browser uitgevoerd. Noch het schema noch de gegevens worden naar een server verzonden — u kunt veilig schema's valideren die interne gegevensstructuren beschrijven en gegevensobjecten die gevoelige veldwaarden bevatten.
De validator ondersteunt JSON Schema drafts 6, 7, 2019-09 en 2020-12. De meest voorkomende draft in het wild is Draft 7, die alle alledaagse sleutelwoorden omvat: type, properties, required, items, minimum, maximum, pattern, enum, anyOf, allOf, oneOf, not en $ref.
Veelgestelde vragen JSON Schema Validator
Welke JSON Schema drafts worden ondersteund?
Ajv ondersteunt drafts 6, 7, 2019-09 en 2020-12. Draft 7 is het meest voorkomend in bestaande codebases en omvat alle standaardsleutelwoorden.
Waarom wordt mijn $ref schema niet opgelost?
Externe $ref URL's worden niet opgehaald in deze browser-only tool. Inline alle gerefereerde schema's met $defs en lokale JSON pointers zoals #/$defs/MyType.
Worden mijn schema of gegevens naar een server geüpload?
Nee. Ajv wordt volledig in uw browser uitgevoerd — zowel schema als gegevens blijven op uw apparaat.
Kan ik dit gebruiken om een OpenAPI 3-spec te valideren?
U kunt individuele schemacomponenten en voorbeeldobjecten valideren. Het valideren van het hele OpenAPI-document vereist een speciale OpenAPI-validator die de spec meta-schema begrijpt.
Waarom zie ik meerdere fouten in plaats van alleen de eerste?
De validator is geconfigureerd met allErrors: true, wat Ajv laat elke fout verzamelen in plaats van bij de eerste te stoppen. Dit is opzettelijk — u kunt alle problemen in één keer oplossen in plaats van herhaalde validatiepogingen.