JSON Schema validator

Kako provjeriti JSON prema shemi

1. Zalijepi shemu u JSON Schema i podatke u JSON dokument, ili odaberi gotov slučaj iz Primjer.
2. Ostavi Verziju (draft) na Automatski ($schema) da se koristi verzija navedena u $schema sheme, ili nametni draft 4, 7, 2019-09 ili 2020-12.
3. Provjera se izvršava dok tipkaš; Provjeri ispravnost je pokreće ponovo. Formatiraj oba ponovo uvlači oba teksta.
4. Pročitaj rezultat: zelena linija kad je dokument ispravan, inače tabela grešaka.

Poruke o greškama koje vraća validator su na engleskom jeziku, dok je ostatak sučelja na bosanskom.

Čitanje tabele grešaka

Svaki red je jedno neuspjelo pravilo:

• Putanja instance je JSON Pointer do vrijednosti koja nije prošla provjeru. /roles/1 je druga stavka u roles; (korijen) je cijeli dokument.
• Ključna riječ je pravilo sheme koje nije ispunjeno: type, required, minimum, pattern, format, additionalProperties i tako dalje.
• Poruka objašnjava grešku, na primjer 0 is less than 1.
• Putanja u shemi pokazuje na ključnu riječ unutar sheme, poput /properties/id/minimum, pa pravilo brzo pronađeš.

Provjera se ne zaustavlja na prvom problemu: navode se sve greške. Kad svojstvo objekta ne prođe provjeru, validator prijavljuje sažetak („Property “id” does not match schema“), a zatim precizan razlog. Prikaži samo najpreciznije greške skriva te sažetke; ukloni oznaku da vidiš cijeli lanac. Greške pod anyOf i oneOf uvijek se zadržavaju zajedno s preciznim greškama svake grane, jer imaju smisla samo zajedno.

Šta je podržano

• Drafti: 4, 6 (provjerava se pravilima drafta 7), 7, 2019-09 i 2020-12, uključujući $defs/definitions, lokalni $ref, if/then/else, dependentRequired, dependentSchemas, prefixItems, unevaluatedProperties i unevaluatedItems.
• Formati: provjeravaju se date, time, date-time, duration, email, hostname, ipv4, ipv6, uri, uri-reference, uri-template, uuid, regex, json-pointer i relative-json-pointer. Nepoznati formati se zanemaruju, kako specifikacija dozvoljava.
• Reference: $ref može pokazivati bilo gdje unutar sheme, uključujući $id koji ona deklariše. Udaljene sheme se nikada ne preuzimaju; referenca na drugi URL prijavljuje se kao neriješena.

Ovaj alat provjerava dokumente prema tvojoj shemi. Ne provjerava da li sama shema prati meta-shemu, ali upozorava na nepoznate nazive type, poput "strin" ili "int", česte greške u kucanju koje validatori inače tiho zanemaruju.

Primjeri

• Korisnički profil (2020-12): required, dužine stringova, format: email, enum unutar items, uniqueItems i additionalProperties: false.
• Lista proizvoda s $ref (draft-07): niz čije stavke referenciraju #/definitions/product, sa pattern za SKU i cijenom s exclusiveMinimum.
• Konfiguracija s if/then (2019-09): certifikat obavezan samo u HTTPS načinu, oneOf između e-pošte i URI-ja te numerička ograničenja.

Svaki primjer dolazi s dokumentom koji sadrži namjerne greške, da vidiš kako izgledaju greške.