JSON (JavaScript Object Notation) adalah format pertukaran data yang dominan di web modern. REST API, file konfigurasi, database NoSQL, dan webhook semuanya menggunakan JSON. Meskipun terlihat sederhana, JSON memiliki aturan sintaks yang ketat — satu karakter yang salah tempat dapat menyebabkan seluruh payload gagal.
Aturan Sintaks JSON yang Harus Diketahui
- String harus menggunakan tanda kutip ganda, bukan tunggal
- Tidak ada trailing comma setelah elemen terakhir dalam objek atau array
- Tidak ada komentar (// atau /* */) — JSON berbeda dari JavaScript
- Kunci harus berupa string yang dikutip ganda
- Nilai dapat berupa string, angka, boolean, null, objek, atau array
Pemformatan vs Minifikasi: Kapan Menggunakan Masing-masing
JSON yang diformat (pretty-printed) menggunakan indentasi dan baris baru untuk membuat struktur dapat dibaca manusia. Ini penting saat debugging, review kode, atau bekerja dengan file konfigurasi. JSON yang diminifikasi menghapus semua whitespace yang tidak perlu untuk menghasilkan payload yang sepadat mungkin — ideal untuk respons API produksi di mana ukuran bandwidth penting.
Kesalahan JSON yang Paling Umum
- Trailing comma: {"key": "value",} — tidak valid dalam JSON meskipun valid dalam JavaScript
- Tanda kutip tunggal: {'key': 'value'} — harus menggunakan tanda kutip ganda
- Kunci yang tidak dikutip: {key: "value"} — kunci harus selalu dikutip
- Komentar: {"key": "value" // komentar} — JSON tidak mendukung komentar
- Nilai undefined: {"key": undefined} — gunakan null sebagai gantinya