Cara Menggunakan JSON Schema untuk Memvalidasi Data Anda

By Tim JSONValidator.dev • 2025-07-04

Apa itu JSON Schema?

JSON Schema adalah cara standar untuk mendeskripsikan struktur, bidang yang wajib, dan tipe nilai pada data JSON Anda. Anggaplah sebagai kontrak atau cetak biru tentang bagaimana JSON yang valid seharusnya terlihat. JSON Schema ditulis dalam format JSON itu sendiri, sehingga mudah dibaca mesin sekaligus mudah diedit.

JSON Schema tidak hanya untuk validasi—ini juga berguna untuk pembuatan kode, dokumentasi API, dan auto-completion di editor.

Mengapa Memvalidasi dengan Schema?

  • Mencegah bug dengan menangkap data yang tidak valid atau hilang sebelum menimbulkan masalah.
  • Menjaga konsistensi data antar tim, aplikasi, atau API.
  • Menghasilkan dokumentasi secara otomatis dari schema.
  • Membantu editor dan alat memberikan auto-completion dan bantuan langsung yang lebih baik.
Schema sederhana sekalipun bisa menangkap kesalahan umum, menghemat waktu debugging berjam-jam.

Contoh Sederhana: Schema Dasar

Berikut ini contoh objek JSON dasar, diikuti oleh schema minimal yang memvalidasi strukturnya:

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

Schema ini memastikan objek harus memiliki 'name' (sebagai string) dan 'age' (sebagai angka).

Cara Menulis Schema Kustom

Anda bisa membuat aturan lanjutan dalam schema: membatasi nilai bidang, mendefinisikan objek bersarang, atau menentukan angka minimum/maksimum. Berikut contoh yang memvalidasi array produk:

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": { "type": "string" },
      "price": { "type": "number", "minimum": 0 },
      "tags": {
        "type": "array",
        "items": { "type": "string" }
      }
    },
    "required": ["id", "price"]
  }
}
Mulailah dari yang sederhana: bangun schema Anda secara bertahap, dan gunakan validator online untuk memeriksa tiap langkah.

Menggunakan JSONValidator.dev untuk Validasi Schema

  1. Tempelkan data JSON Anda di editor utama.
  2. Tempelkan JSON Schema Anda di editor schema di bawah.
  3. Klik Validasi JSON dengan Schema ini.
  4. Tinjau hasil validasi, dengan error yang disorot dan dijelaskan.
Semua proses validasi dilakukan di browser Anda—data Anda tidak pernah keluar dari perangkat Anda.

Memecahkan Masalah Kesalahan Validasi Schema

Penyebab umum kesalahan validasi meliputi:

  • Bidang wajib tidak ada dalam data Anda.
  • Tipe nilai tidak sesuai schema (misal, string vs angka).
  • Schema itu sendiri tidak valid atau mengandung kesalahan ketik.
Periksa pesan error dengan cermat—biasanya mereka menunjukkan bidang dan ketidaksesuaian tipe secara tepat.

Kesimpulan

Validasi JSON Schema adalah cara ampuh agar data Anda menjadi kuat dan bebas kesalahan. Cobalah buat schema untuk data Anda sendiri dengan Generator JSON Schema gratis kami dan validasi secara langsung!