Kako koristiti JSON Schema za validaciju podataka

By JSONValidator.dev tim • 2025-07-04

Što je JSON Schema?

JSON Schema je standardizirani način opisivanja strukture, obaveznih polja i tipova vrijednosti u vašim JSON podacima. Zamislite je kao ugovor ili nacrt koji definira kako valjani JSON treba izgledati. JSON Schema je napisana u samom JSON formatu, što je čini čitljivom za strojeve i jednostavnom za uređivanje.

JSON Schema nije samo za validaciju — korisna je i za generiranje koda, dokumentaciju API-ja te automatsko dovršavanje u uređivačima.

Zašto validirati pomoću sheme?

  • Spriječite pogreške hvatanjem nevažećih ili nedostajućih podataka prije nego što izazovu probleme.
  • Osigurajte dosljednost podataka između različitih timova, aplikacija ili API-ja.
  • Automatski generirajte dokumentaciju iz shema.
  • Pomoću shema omogućite uređivačima i alatima bolje automatsko dovršavanje i pomoć u liniji koda.
Čak i jednostavna shema može otkriti česte pogreške, štedeći sate ispravljanja kasnije.

Jednostavan primjer: osnovna shema

Evo osnovnog JSON objekta, a zatim minimalna shema koja validira njegovu strukturu:

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

Ova shema osigurava da objekt mora imati polje 'name' (tipa string) i 'age' (tipa broj).

Kako napisati prilagođenu shemu

Možete definirati napredna pravila u svojoj shemi: ograničiti vrijednosti polja, definirati ugniježdene objekte ili postaviti minimalne/maksimalne brojeve. Evo primjera koji validira niz proizvoda:

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": { "type": "string" },
      "price": { "type": "number", "minimum": 0 },
      "tags": {
        "type": "array",
        "items": { "type": "string" }
      }
    },
    "required": ["id", "price"]
  }
}
Počnite jednostavno: gradite shemu korak po korak i koristite online validatore za provjeru svakog koraka.

Korištenje JSONValidator.dev za validaciju shema

  1. Zalijepite svoje JSON podatke u glavni uređivač.
  2. Zalijepite svoju JSON shemu u uređivač sheme ispod.
  3. Kliknite Validate JSON Against This Schema.
  4. Pregledajte rezultate validacije, uz istaknute i objašnjene pogreške.
Sva validacija odvija se u vašem pregledniku — vaši podaci nikada ne napuštaju vaš uređaj.

Rješavanje problema s pogreškama validacije sheme

Česti razlozi za pogreške validacije uključuju:

  • Nedostaje obavezno polje u podacima.
  • Tip vrijednosti ne odgovara shemi (npr. string umjesto broja).
  • Sama shema je nevažeća ili sadrži tipografske pogreške.
Pažljivo provjerite poruke o pogreškama — često će pokazati točno polje i nesklad tipova.

Zaključak

Validacija pomoću JSON Sheme snažan je način da vaši podaci budu robusni i bez grešaka. Isprobajte izradu sheme za vlastite podatke koristeći naš besplatni generator JSON Sheme i validirajte uživo!