Viktiga punkter
- 01Driven av Ajv, den mest använda JavaScript JSON Schema-validatorn — det som passerar här passerar i Node.js, Fastify och de flesta JS-verktygskedjar.
- 02Rapporterar varje valideringsfel på en gång (allErrors-läge), inte bara det första misslycket.
- 03Varje fel inkluderar JSON Pointer-vägen till det felande fältet för snabb navigering.
- 04Både schema och data körs helt i din webbläsare — ingenting är uppladdat.
Varför validera JSON mot ett schema?
JSON Schema är standardsättet att beskriva formen på ett JSON-dokument — nödvändiga fält, tillåtna typer, värdebegränsningar, kapslade objektstrukturer. Att validera mot ett schema innan en last når produktion fångar typmatchningar, saknade nödvändiga fält och begränsningsöverträdelser tidigt, när de är billiga att fixa.
De vanligaste användningsförsöken är att testa API-begäran och svarskroppar, validera konfigurationsfiler, kontrollera OpenAPI-exemplen och verifiera dataexporter mot en känd struktur. Handytools validatorn använder Ajv — JavaScript JSON Schema-standardbiblioteket, används inuti själva Node.js — så resultaten här matchar vad din backend kommer att se.
Hur man validerar JSON mot ett schema
- 01
Klistra in ditt JSON-schema
Klistra in schemat i den vänstra panelen. Det kan vara ett Draft 7 eller 2019-09 eller 2020-12 schema med typ, egenskaper, obligatorisk, items, anyOf, allOf — valfritt standard Ajv-stödd nyckelord.
- 02
Klistra in dina JSON-data
Klistra in datadokumentet du vill validera i den högra panelen. Det här är instansen — en API-begärandekropp, ett konfigurationsobjekt, en exportrad eller ett enda exempel från din OpenAPI-spec.
- 03
Klicka Validera
Ajv kör valideringen med allErrors: true, vilket innebär att det samlar varje misslyckande snarare än att stoppa vid det första.
- 04
Granska feltlistan
Varje fel visar JSON Pointer-vägen till det felande värdet (t.ex. /user/email), det felande nyckelordet (typ, obligatorisk, minimum) och ett människoläsbart meddelande. Fixa var och en och omkontrollera.
Vad utvecklare validerar med JSON Schema
- 01REST API-begärandekroppar — bekräfta att en last matchar slutpunktens förväntade form innan den skickas.
- 02OpenAPI spec-exempel objekter — validera varje exempel mot den inline-schemakomponenten.
- 03Konfigurationsfiler — säkerställ att nödvändiga nycklar är närvarande och värden är rätt typ.
- 04Data pipeline-poster — se strukturdrift mellan dataproducenter och konsumenter.
- 05Formulärinlämningslaster — testa att frontendsvalidering speglar backend-schemabegränsningar.
- 06Tredje partes webhook-kroppar — bekräfta att det dokumenterade schemat matchar den faktiska lasten.
Privat validering, ingen server krävs
Ajv körs helt i din webbläsare. Varken schemat eller data skickas till någon server — du kan säkert validera scheman som beskriver interna datastrukturer och dataobjekt som innehåller känsliga fältvärden.
Validatorn stöder JSON Schema-utkast 6, 7, 2019-09 och 2020-12. Det vanligaste utkastet i vildmarken är Draft 7, som täcker alla vardagsnyckelord: typ, egenskaper, obligatorisk, items, minimum, maximum, mönster, enum, anyOf, allOf, oneOf, inte och $ref.
JSON Schema Validator FAQ
Vilka JSON-schemaformulär stöds?
Ajv stöder utkast 6, 7, 2019-09 och 2020-12. Draft 7 är det vanligaste i befintliga kodlager och täcker alla standardnyckelord.
Varför löses inte mitt $ref-schema?
Externa $ref-URL:er hämtas inte i det här webbläsareverktyget. Bädda in alla refererade scheman med $defs och lokala JSON-pekare som #/$defs/MyType.
Är mitt schema eller data uppladdat till någon server?
Nej. Ajv körs helt i din webbläsare — både schema och data stannar på din enhet.
Kan jag använda detta för att validera en OpenAPI 3 spec?
Du kan validera individuella schemakomponenter och exemplen objekter. Att validera hela OpenAPI-dokumentet kräver en dedikerad OpenAPI-validator som förstår specens metaschema.
Varför ser jag flera fel istället för bara det första?
Validatorn är konfigurerad med allErrors: true, vilket gör Ajv samlar varje misslyckande snarare än att stoppa vid det första. Detta är avsiktligt — du kan fixa alla problem i ett pass snarare än att göra upprepade valideringsförsök.