Paano Gumamit ng JSON Schema para I-validate ang Iyong Data

By JSONValidator.dev Team • 2025-07-04

Ano ang JSON Schema?

Ang JSON Schema ay isang standard na paraan upang ilarawan ang istruktura, mga kinakailangang field, at mga uri ng halaga sa iyong JSON data. Isipin ito bilang isang kontrata o blueprint kung ano ang dapat anyo ng isang valid na JSON. Ang JSON Schema ay isinusulat gamit ang JSON mismo, kaya ito ay nababasa ng makina at madaling baguhin.

Ang JSON Schema ay hindi lang para sa validation—kapaki-pakinabang din ito para sa paggawa ng code, dokumentasyon ng API, at auto-completion ng editor.

Bakit Mag-validate gamit ang Schema?

  • Maiiwasan ang mga bug sa pamamagitan ng pagtukoy ng invalid o kulang na data bago ito magdulot ng problema.
  • Masigurado ang pagkakapareho ng data sa iba't ibang koponan, apps, o APIs.
  • Awtomatikong makagawa ng dokumentasyon mula sa mga schema.
  • Tumutulong sa mga editor at tool na magbigay ng mas mahusay na auto-completion at tulong habang nagta-type.
Kahit ang simpleng schema ay makakapag-detect ng mga karaniwang pagkakamali, nakakatipid ng oras sa pag-debug.

Isang Simpleng Halimbawa: Pangunahing Schema

Narito ang isang basic na JSON object, kasunod ang isang minimal na schema na nagva-validate sa istruktura nito:

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

Tinitiyak ng schema na dapat may 'name' (bilang string) at 'age' (bilang number) ang object.

Paano Sumulat ng Custom na Schema

Maaari kang magtakda ng mas advanced na mga patakaran sa iyong schema: limitahan ang mga halaga ng field, mag-define ng nested objects, o magtakda ng minimum/maximum na numero. Narito ang isang halimbawa na nagva-validate ng array ng mga produkto:

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": { "type": "string" },
      "price": { "type": "number", "minimum": 0 },
      "tags": {
        "type": "array",
        "items": { "type": "string" }
      }
    },
    "required": ["id", "price"]
  }
}
Magsimula sa maliit: buuin ang iyong schema habang umuusad ka, at gamitin ang mga online validator para suriin ang bawat hakbang.

Paggamit ng JSONValidator.dev para sa Schema Validation

  1. I-paste ang iyong JSON data sa pangunahing editor.
  2. I-paste ang iyong JSON Schema sa schema editor sa ibaba.
  3. I-click ang I-validate ang JSON gamit ang Schema na ito.
  4. Suriin ang mga resulta ng validation, may mga error na naka-highlight at ipinaliwanag.
Lahat ng validation ay nangyayari sa iyong browser—hindi kailanman lumalabas ang iyong data mula sa iyong device.

Pagsasaayos ng Mga Error sa Schema Validation

Karaniwang mga dahilan ng error sa validation ay kinabibilangan ng:

  • May nawawalang kinakailangang field sa iyong data.
  • Ang uri ng halaga ay hindi tumutugma sa schema (hal., string kumpara sa number).
  • Ang schema mismo ay hindi valid o may mga typo.
Maingat na suriin ang mga mensahe ng error—madalas nilang ipinapakita ang eksaktong field at uri ng hindi pagtutugma.

Konklusyon

Ang JSON Schema validation ay isang makapangyarihang paraan para gawing matibay at error-proof ang iyong data. Subukan gumawa ng schema para sa sarili mong data gamit ang aming libreng JSON Schema Generator at i-validate ito nang live!