Pembuat JSON Schema
Buat JSON Schema dari data JSON secara otomatis
Disimpulkan dari data contoh. Schema item array mengikuti item pertama; tinjau dan sempurnakan schema sebelum validasi.
Diproses di perangkat ini. Teks Anda tidak diunggah.
Pembuat JSON Schema online gratis
Alat pembuat JSON Schema kami menganalisis data JSON contoh dan langsung menghasilkan definisi JSON Schema yang valid dengan deteksi tipe yang akurat, penanganan objek bersarang, dan inferensi item array. Cukup tempel objek JSON, pilih versi draft yang Anda inginkan, dan dapatkan schema yang bisa dipakai untuk validasi API, pembuatan formulir, atau dokumentasi, tanpa perlu menulis satu baris kode schema pun secara manual.
Alat ini mendukung JSON Schema draft-04, draft-06, dan draft-07, yaitu versi yang paling banyak dipakai di ekosistem. Alat ini menelusuri struktur JSON Anda secara rekursif dan mendeteksi string, angka, bilangan bulat, boolean, null, objek, dan array. Untuk array, schema disimpulkan dari elemen pertama sehingga definisi item tetap akurat bahkan untuk struktur bersarang yang kompleks.
Opsi yang dapat dikonfigurasi memungkinkan Anda mengaktifkan array properti required, menambahkan placeholder deskripsi untuk dokumentasi, dan menerapkan additionalProperties: false untuk validasi yang ketat. Jika sudah puas, unduh hasilnya sebagai file .schema.json atau salin ke papan klip dengan satu klik. Semuanya berjalan secara lokal di browser Anda, sehingga data Anda tidak pernah diunggah ke server.
Fitur utama
- Mendukung JSON Schema draft-04, draft-06, dan draft-07 dengan URI $schema yang tepat
- Deteksi tipe otomatis untuk string, number, integer, boolean, null, object, dan array
- Pembuatan schema rekursif untuk objek dan array yang bersarang dalam
- Inferensi tipe item array berdasarkan elemen pertama
- Array properti "required" yang dapat dikonfigurasi untuk mengatur ketatnya validasi
- Pembuatan placeholder "description" opsional untuk schema yang mendokumentasikan dirinya sendiri
- Toggle "additionalProperties: false" untuk menerapkan bentuk objek yang ketat
- Unduh schema yang dihasilkan sebagai file .schema.json
- Salin ke papan klip dengan satu klik
- JSON contoh yang sudah dimuat untuk bereksperimen dengan cepat
Cara menggunakan Pembuat JSON Schema
- Atur opsi schema: Pilih versi draft, lalu aktifkan atau nonaktifkan array required, deskripsi, dan additionalProperties sesuai kebutuhan Anda.
- Tempel JSON Anda: Ketik atau tempel objek JSON contoh ke panel input. Anda juga dapat mengklik "Sample JSON" untuk memuat contoh.
- Buat schema: Klik "Generate Schema" untuk menghasilkan keluaran JSON Schema di panel kanan.
- Tinjau dan sempurnakan: Periksa hasilnya. Ubah opsi seperti field required atau deskripsi, lalu buat ulang jika perlu.
- Ekspor schema: Klik "Copy" untuk menaruh schema di papan klip Anda, atau "Download .schema.json" untuk menyimpannya sebagai file.
Kasus penggunaan
- Spesifikasi OpenAPI / Swagger: Buat definisi schema untuk body permintaan dan respons dalam dokumentasi API Anda.
- Validasi permintaan backend: Buat schema untuk memvalidasi payload JSON masuk di Express, FastAPI, Spring Boot, atau framework lainnya.
- Pembuatan formulir frontend: Masukkan schema ke pustaka seperti react-jsonschema-form untuk membuat formulir UI secara otomatis dari model data.
- Kontrak data: Tentukan dan bagikan kontrak data terstruktur antar microservice atau antara tim frontend dan backend.
- Validasi konfigurasi: Validasi file konfigurasi JSON dalam pipeline CI/CD untuk menangkap kesalahan struktur sebelum deployment.
- Perencanaan migrasi database: Dokumentasikan bentuk data yang diharapkan saat merancang tabel atau koleksi baru.
- Pelengkapan otomatis IDE: Rujuk JSON Schema di pengaturan VS Code untuk mengaktifkan IntelliSense dan validasi pada file JSON kustom.
Pertanyaan yang sering diajukan
Apakah alat ini gratis?
Ya, pembuat JSON Schema ini sepenuhnya gratis tanpa pendaftaran atau batas penggunaan. Buat schema untuk objek JSON sebanyak apa pun tanpa biaya.
Apakah data saya aman?
Ya. Seluruh pembuatan schema berlangsung di browser Anda. Data JSON Anda tidak pernah dikirim ke server mana pun, sehingga aman dipakai dengan payload API milik sendiri atau struktur data internal.
Apa itu JSON Schema?
JSON Schema adalah kosakata deklaratif untuk memberi anotasi dan memvalidasi dokumen JSON. JSON Schema menjelaskan struktur, tipe data, properti required, dan batasan yang diharapkan dari sebuah objek JSON. Format ini banyak dipakai dalam spesifikasi API (OpenAPI/Swagger), pustaka pembuat formulir, dan alat validasi konfigurasi.
Versi draft mana yang sebaiknya saya pakai?
Draft-07 direkomendasikan untuk sebagian besar proyek karena merupakan versi yang paling banyak didukung di berbagai pustaka validasi dan tooling. Gunakan draft-04 atau draft-06 hanya jika toolchain Anda secara khusus membutuhkan versi yang lebih lama.
Bisakah saya mengedit schema yang dihasilkan?
Schema yang dihasilkan hanyalah titik awal. Setelah mengunduh atau menyalinnya, Anda dapat menambahkan secara manual batasan seperti minLength, maximum, nilai enum, atau regex pattern yang tidak dapat disimpulkan dari data contoh saja.
Apakah alat ini menangani array bertipe campuran?
Pembuat ini menyimpulkan tipe item array dari elemen pertama. Jika array Anda berisi tipe campuran, Anda mungkin perlu menyesuaikan definisi items secara manual menjadi schema oneOf atau anyOf setelah pembuatan.
Tips & praktik terbaik
- Sediakan data contoh yang representatif: Sertakan semua field yang mungkin ada di JSON contoh Anda agar schema mencakup seluruh strukturnya.
- Aktifkan array required: Nyalakan opsi "required" untuk menerapkan field wajib saat schema dipakai untuk validasi.
- Tambahkan deskripsi belakangan: Aktifkan placeholder deskripsi saat pembuatan, lalu gantilah dengan dokumentasi yang bermakna sebelum membagikan schema.
- Gunakan additionalProperties: false untuk API yang ketat: Ini mencegah klien mengirim field tak terduga yang dapat menimbulkan masalah di hilir.
- Validasi setelah pembuatan: Uji schema Anda terhadap beberapa payload contoh memakai validator JSON Schema untuk memastikan kasus tepi tertangani.
- Beri versi pada schema Anda: Simpan file schema di version control bersama kode API Anda untuk melacak perubahan dari waktu ke waktu.