JSON Schema Validator

Apa itu JSON Schema Validator?

// A 5-line schema that catches three real bugs
const schema = {
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id":    { "type": "integer", "minimum": 1 },
    "email": { "type": "string", "format": "email" },
    "age":   { "type": "integer", "minimum": 0, "maximum": 150 }
  },
  "required": ["id", "email"],
  "additionalProperties": false
};

// Three bugs the schema catches:
const bad = { "id": "42", "age": 200 };
//   /id   → type: expected integer, got string
//   /email → required: missing
//   /age   → maximum: 200 > 150

// In Node:        new Ajv().compile(schema)(bad)  // false; ajv.errors has the paths
// In Python:      jsonschema.validate(bad, schema)
// In the browser: this tool — same errors, same paths, no install

Fitur Utama

Contoh

{
  "id": 42,
  "email": "alice@example.com",
  "age": 30
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": { "type": "integer", "minimum": 1 },
    "email": { "type": "string", "format": "email" },
    "age": { "type": "integer", "minimum": 0, "maximum": 150 }
  },
  "required": ["id", "email"],
  "additionalProperties": false
}

{
  "id": "42",
  "age": 200
}

{
  "type": "object",
  "properties": {
    "id": { "type": "integer" },
    "email": { "type": "string", "format": "email" },
    "age": { "type": "integer", "maximum": 150 }
  },
  "required": ["id", "email"]
}

{
  "type": "order.created",
  "data": { "orderId": "ORD-001234", "totalUsd": 49.99 }
}

{
  "oneOf": [
    {
      "properties": {
        "type": { "const": "order.created" },
        "data": {
          "type": "object",
          "properties": {
            "orderId": { "type": "string", "pattern": "^ORD-[0-9]{6}$" },
            "totalUsd": { "type": "number", "minimum": 0 }
          },
          "required": ["orderId", "totalUsd"]
        }
      },
      "required": ["type", "data"]
    },
    {
      "properties": {
        "type": { "const": "order.refunded" },
        "data": { "type": "object", "required": ["refundId"] }
      },
      "required": ["type", "data"]
    }
  ]
}

[
  { "sku": "A1", "qty": 3 },
  { "sku": "B2", "qty": 5 },
  { "sku": "A1", "qty": 3 }
]

{
  "type": "array",
  "minItems": 1,
  "uniqueItems": true,
  "items": {
    "type": "object",
    "properties": {
      "sku": { "type": "string", "pattern": "^[A-Z][0-9]+$" },
      "qty": { "type": "integer", "minimum": 1 }
    },
    "required": ["sku", "qty"]
  }
}

Cara Penggunaan

1. 1

   Tempelkan JSON Schema Anda

   Letakkan schema Anda di panel kanan. Validator mendeteksi draft otomatis dari URI $schema bila ada; jika tidak, pilih Draft 2020-12, 2019-09, atau Draft-07 dari toolbar.

2. 2

   Tempelkan data JSON Anda

   Letakkan dokumen JSON yang ingin diperiksa di panel kiri. Validasi berjalan saat mengetik; input besar (>200 KB) beralih ke tombol Validate manual agar pengetikan tetap responsif.

3. 3

   Baca daftar error

   Setiap error memiliki path JSON Pointer, keyword, dan pesan satu baris. Klik error untuk melompat ke lokasi di data Anda, perbaiki, dan saksikan jumlahnya menurun secara real time.

Jebakan Umum JSON Schema

{ "qty": 1.0 }   schema: { "type": "integer" }   → error: not an integer

{ "qty": 1 }     schema: { "type": "integer" }   → valid

{ "properties": { "name": { "type": "string", "required": true } } }

{ "properties": { "name": { "type": "string" } }, "required": ["name"] }

{ "properties": { "id": { "type": "integer" } } }   accepts: { "id": 1, "foo": "bar", "x": null }

{ "properties": { "id": { "type": "integer" } }, "additionalProperties": false }

{ "type": "string", "nullable": true }   in 2020-12: nullable is just an unknown keyword

{ "type": ["string", "null"] }   in 2020-12: explicitly allows null

pattern: "[A-Z]+"   accepts: "helloX"   (because X matches)

pattern: "^[A-Z]+$"   accepts only: "HELLO"

oneOf: [ { type: "string" }, { type: "string", maxLength: 10 } ]   on: "hi"   → error: matches both

anyOf: [ { type: "string" }, { type: "string", maxLength: 10 } ]   on: "hi"   → valid

Kasus Penggunaan Umum

Validasi Request API

Tempel request body dan schema endpoint Anda sebelum deploy. Tangkap response 400 yang tidak tercakup test — field required hilang, type salah, angka di luar rentang.

Verifikasi Payload Webhook

Vendor mengirim payload yang ditolak handler Anda? Validasi payload aktual terhadap schema Anda, lalu terhadap schema yang diterbitkan vendor. Selisih antara keduanya adalah bug Anda.

Linting File Konfigurasi

package.json, tsconfig.json, helm values.yaml — setiap file konfigurasi memiliki schema publik. Tempel schema, tempel konfigurasi, temukan typo. Lewati trial-and-error.

Pengujian Komponen OpenAPI

Ambil komponen schema dari dokumen OpenAPI 3.1, tempel di sini, validasi payload sample. Lebih cepat daripada menyalakan mock server, deterministik, tanpa SDK.

Pre-Flight Form Submission

Tempel sample payload form sebelum menyambung validasi frontend. Konfirmasi bahwa schema menolak yang Anda kira ditolak, menerima yang Anda kira diterima, lalu kirim schema yang sama ke client dan server.

Pemeriksaan Kontrak Data Pipeline

Output ETL drift? Tempel sample row dan schema downstream. Identifikasi producer mana yang berubah dan key mana yang rusak sebelum pipeline retry 10.000 record.

Detail Teknis

Sesuai Draft 2020-12

Mengimplementasikan spesifikasi Draft 2020-12 yang dipublikasikan — keyword, sistem type, kosakata format. Diuji silang dengan output Ajv 8.x dan ajv-formats.

Path Error JSON Pointer

Error menggunakan JSON Pointer RFC 6901 (/user/email/0). Setiap kegagalan keyword menunjuk satu lokasi yang dapat diresolve di data — tanpa ambiguitas, tanpa string-search.

Resolusi $ref Internal

Meresolve pointer $ref di dalam satu dokumen (#/$defs/foo, #/properties/bar). Cycle dideteksi dan dilaporkan. $ref HTTP eksternal dinonaktifkan untuk privasi.

Praktik Terbaik

Selalu Set additionalProperties: false

Pada kontrak input (request body, file konfigurasi, queue message), key tidak dikenal biasanya bug — typo, field tak sengaja, atau probing penyerang. Tolak secara default.

Gunakan $defs untuk Subschema yang Reusable

Inline shape yang sama dua kali dan keduanya akan drift. Pindahkan definisi bersama ke $defs dan rujuk dengan $ref — satu source of truth, setiap perubahan berlaku di semua tempat.

Validasi Sebelum Business Logic

Jalankan validasi schema tepat setelah JSON.parse, sebelum menyentuh struktur yang sudah diparsing. Type narrowing, defaulting, dan persistence semuanya berasumsi kontrak terpenuhi — pastikan iya.

Pertanyaan yang Sering Diajukan