Kaip naudoti JSON schemą duomenų tikrinimui

By JSONValidator.dev komanda • 2025-07-04

Kas yra JSON schema?

JSON schema yra standartizuotas būdas aprašyti JSON duomenų struktūrą, privalomus laukus ir reikšmių tipus. Tai tarsi sutartis arba planas, kaip turėtų atrodyti galiojantis JSON. JSON schema rašoma paties JSON kalba, todėl yra lengvai suprantama tiek mašinoms, tiek redaguojama žmonių.

JSON schema nėra skirta tik patikrinimui – ji taip pat naudinga kodo generavimui, API dokumentacijai ir redaktorių automatinio užbaigimo funkcijoms.

Kodėl verta tikrinti duomenis su schema?

  • Išvengti klaidų, aptikus neteisingus ar trūkstamus duomenis prieš jiems sukeliant problemų.
  • Užtikrinti duomenų nuoseklumą tarp skirtingų komandų, programų ar API.
  • Automatiškai generuoti dokumentaciją iš schemų.
  • Padėti redaktoriams ir įrankiams teikti geresnį automatinį užbaigimą ir pagalbą.
Net paprasta schema gali aptikti dažnas klaidas, sutaupydama valandas derinimo laiko.

Paprastas pavyzdys: pagrindinė schema

Štai paprastas JSON objektas ir minimali schema, tikrinanti jo struktūrą:

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

Ši schema užtikrina, kad objektas turi turėti lauką 'name' (teksto tipo) ir 'age' (skaičiaus tipo).

Kaip parašyti savo schemą

Galite apibrėžti sudėtingesnes taisykles: riboti laukų reikšmes, aprašyti įdėtus objektus arba nustatyti minimalius/maksimalius skaičius. Štai pavyzdys, tikrinantis produktų masyvą:

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": { "type": "string" },
      "price": { "type": "number", "minimum": 0 },
      "tags": {
        "type": "array",
        "items": { "type": "string" }
      }
    },
    "required": ["id", "price"]
  }
}
Pradėkite nuo paprasto: kurkite schemą palaipsniui ir naudokite internetinius tikrintuvus kiekvienam žingsniui patikrinti.

Kaip naudotis JSONValidator.dev duomenų tikrinimui su schema

  1. Įklijuokite savo JSON duomenis pagrindiniame redaktoriuje.
  2. Įklijuokite savo JSON schemą apačioje esančiame schemos redaktoriuje.
  3. Paspauskite Tikrinti JSON pagal šią schemą.
  4. Peržiūrėkite tikrinimo rezultatus, klaidos bus pažymėtos ir paaiškintos.
Visa tikrinimo veikla vyksta jūsų naršyklėje – duomenys niekada neiškeliauja iš jūsų įrenginio.

Kaip spręsti schemos tikrinimo klaidas

Dažniausios klaidų priežastys yra:

  • Jūsų duomenyse trūksta privalomo lauko.
  • Reikšmės tipas nesutampa su schema (pvz., tekstas vietoje skaičiaus).
  • Schema pati yra neteisinga arba klaidinga.
Atidžiai peržiūrėkite klaidų pranešimus – jie dažnai nurodo tikslų lauką ir tipų neatitikimą.

Išvada

JSON schemos tikrinimas yra galingas būdas užtikrinti jūsų duomenų patikimumą ir klaidų nebuvimą. Išbandykite sukurti schemą savo duomenims su mūsų nemokamu JSON schemos generatoriumi ir patikrinkite ją tiesiogiai!