Cara Menggunakan Skema JSON untuk Mengesahkan Data Anda

By Pasukan JSONValidator.dev • 2025-07-04

Apakah Skema JSON?

Skema JSON adalah cara standard untuk menggambarkan struktur, medan yang diperlukan, dan jenis nilai dalam data JSON anda. Anggap ia seperti kontrak atau pelan untuk bagaimana JSON yang sah sepatutnya kelihatan. Skema JSON ditulis dalam format JSON itu sendiri, menjadikannya boleh dibaca mesin dan mudah untuk diedit.

Skema JSON bukan hanya untuk pengesahan—ia juga berguna untuk penjanaan kod, dokumentasi API, dan pengecaman automatik editor.

Mengapa Mengesahkan dengan Skema?

  • Mengelakkan pepijat dengan mengesan data tidak sah atau hilang sebelum ia menyebabkan masalah.
  • Menegakkan konsistensi data merentasi pelbagai pasukan, aplikasi, atau API.
  • Menjana dokumentasi secara automatik daripada skema.
  • Membantu editor dan alat menyediakan pengecaman automatik dan bantuan dalam talian yang lebih baik.
Walaupun skema ringkas boleh mengesan kesilapan biasa, menjimatkan berjam-jam masa pembetulan kemudian.

Contoh Ringkas: Skema Asas

Ini adalah objek JSON asas, diikuti dengan skema minimum yang mengesahkan strukturnya:

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

Skema ini memastikan objek mesti mempunyai 'name' (sebagai string) dan 'age' (sebagai nombor).

Cara Menulis Skema Tersuai

Anda boleh mentakrifkan peraturan lanjutan dalam skema anda: mengehadkan nilai medan, mentakrif objek bersarang, atau menetapkan nombor minimum/maksimum. Berikut contoh yang mengesahkan susunan produk:

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": { "type": "string" },
      "price": { "type": "number", "minimum": 0 },
      "tags": {
        "type": "array",
        "items": { "type": "string" }
      }
    },
    "required": ["id", "price"]
  }
}
Mula dengan mudah: bina skema anda secara berperingkat, dan gunakan pengesah dalam talian untuk memeriksa setiap langkah.

Menggunakan JSONValidator.dev untuk Pengesahan Skema

  1. Tampal data JSON anda dalam editor utama.
  2. Tampal Skema JSON anda dalam editor skema di bawah.
  3. Klik Sahkan JSON Mengikut Skema Ini.
  4. Semak keputusan pengesahan, dengan sebarang ralat ditandakan dan diterangkan.
Semua pengesahan berlaku dalam pelayar anda—data anda tidak pernah meninggalkan peranti anda.

Menyelesaikan Masalah Ralat Pengesahan Skema

Sebab biasa ralat pengesahan termasuk:

  • Medan yang diperlukan hilang dalam data anda.
  • Jenis nilai tidak sepadan dengan skema (contoh: string berbanding nombor).
  • Skema itu sendiri tidak sah atau mengandungi kesilapan taip.
Periksa mesej ralat dengan teliti—ia sering memberitahu medan dan ketidakpadanan jenis yang tepat.

Kesimpulan

Pengesahan Skema JSON merupakan cara berkuasa untuk menjadikan data anda kukuh dan bebas kesilapan. Cuba cipta skema untuk data anda sendiri dengan Penjana Skema JSON percuma kami dan sahkan secara langsung!