Penjana JSON Schema

Jana JSON Schema daripada data anda atau sahkan JSON terhadap skema sedia ada

Penjana JSON Schema

Versi Draf

Tandakan semua medan sebagai wajib

Benarkan sifat tambahan

Input JSON

Data JSON

JSON Schema

100% di sisi klien. Data JSON anda tidak pernah meninggalkan pelayar anda.

Contoh Penggunaan

Gunakan Draft-07 untuk ciri terkini termasuk skema bersyarat dan pengekodan kandungan.

Aktifkan "Tandakan semua medan sebagai wajib" apabila anda memerlukan pengesahan ketat medan mandatori.

Muat turun skema yang dijana dan tambahkan ke projek anda untuk pengesahan CI automatik.

Tampal contoh respons API untuk mencipta skema dengan pantas bagi dokumentasi anda.

JSON Schema Types

Supported JSON Schema data types:

string - Text values
number - Decimal numbers
integer - Whole numbers
boolean - true/false
array - Ordered lists
object - Key-value pairs
null - Null value

Ciri-ciri

Penjanaan Schema Automatik

Tampal sebarang JSON dan dapatkan skema lengkap dengan jenis, format dan struktur dikesan secara automatik

Pengesahan Schema

Sahkan data JSON terhadap sebarang skema dan lihat mesej ralat terperinci untuk ketidaksepadanan

Pelbagai Versi Draf

Sokongan untuk Draft-04, Draft-06 dan Draft-07 mengikut keperluan projek anda

Peribadi & Luar Talian

Berjalan sepenuhnya dalam pelayar anda, tiada data JSON dihantar ke mana-mana pelayan

Cara Menggunakan

Tampal JSON Anda

Tampal data JSON anda ke kawasan input atau cuba salah satu contoh yang disediakan.

Konfigurasi Pilihan

Pilih versi draf dan togol pilihan seperti medan wajib dan sifat tambahan.

Jana atau Sahkan

Klik Jana Schema untuk mencipta skema, atau tukar ke tab Sahkan untuk menyemak JSON terhadap skema.

Soalan Lazim

Skema JSON adalah kosa kata untuk memberi nota dan mengesahkan dokumen JSON. Ia menerangkan struktur yang dijangkakan, jenis data, medan wajib, dan kekangan JSON anda. Dokumen skema itu sendiri adalah JSON dan boleh digunakan untuk pengesahan automatik payload API, input borang, fail konfigurasi, atau rekod pangkalan data. Ia adalah asas bagi spesifikasi OpenAPI/Swagger dan digunakan secara meluas dalam saluran CI untuk ujian kontrak data.

Tampal mana-mana JSON yang sah dan klik Generate Schema. Alat ini meneliti setiap hartanah secara rekursif, merumuskan jenis (string, number, integer, boolean, null, object, array), mengesan format string biasa (date-time, email, URI, UUID), dan menghasilkan pokok skema yang lengkap. Pilihan yang tersedia membolehkan anda menandakan semua medan sebagai wajib, melarang hartana tambahan, atau menambah placeholder penerangan untuk dokumentasi.

Draft-07 adalah pilihan yang tepat untuk kebanyakan projek — ia adalah versi yang paling mendapat sokongan luas dan menambah ciri-ciri seperti syarat if/then/else dan kata kunci pengekodan kandungan. Draft-06 memperkenalkan "const" dan "contains". Draft-04 adalah yang tertua dan hanya perlu digunakan jika alat khusus (validator lama, beberapa peralatan Swagger 2.0) memerlukannya secara eksplisit. Jika ragu-ragu, gunakan Draft-07.

Ya. Tukar ke tab Validate, tampal data JSON anda di panel kiri dan skema anda di panel kanan, kemudian klik Validate. Alat ini menjalankan pengesahan penuh dan melaporkan setiap ralat dengan laluan medan dan penerangan pelanggaran. Ini membolehkan anda menyemak JSON daripada API, penghantaran borang, atau fail konfigurasi berpandukan mana-mana skema — bukan sekadar yang dijana oleh alat ini.

Kata kunci required menyenaraikan medan yang mesti ada dalam JSON. Apabila anda mengaktifkan "Mark all fields as required", setiap kunci yang ditemui dalam sampel JSON anda akan ditambah ke dalam tatasusunan required. Dalam praktiknya, anda biasanya akan menyunting senarai ini selepas penjanaan — buang kunci yang benar-benar pilihan. Medan yang wajib bermaksud pengesahan gagal jika kunci itu tiada; ia tidak menyatakan apa-apa tentang nilai medan tersebut sebagai bukan null.

Apabila additionalProperties ditetapkan kepada false dalam skema, pengesahan akan menolak mana-mana JSON yang mengandungi kunci yang tidak ditakrifkan dalam objek properties. Ini berguna untuk kontrak API yang ketat di mana anda ingin menangkap kesilapan taip pada nama medan atau menghalang pelanggan daripada menghantar medan yang tidak diisytiharkan. Membiarkannya pada true (atau tidak menyertakannya) membenarkan mana-mana medan tambahan tanpa ralat pengesahan — lebih baik untuk skema yang serasi dengan ke hadapan.

Muat turun atau salin skema, kemudian gunakan pustaka pengesahan: Ajv (JavaScript/Node.js), jsonschema atau jsonschema-rs (Python/Rust), Newtonsoft.Json.Schema (C#), atau NetworkNT JSON Schema Validator (Java). Dalam Ajv: const validate = ajv.compile(schema); const valid = validate(data). Fail skema juga boleh dirujuk dalam spesifikasi OpenAPI di bawah components/schemas untuk dokumentasi yang dijana secara automatik.

Ya. Alat ini berjalan 100% dalam pelayar anda. Data JSON anda tidak pernah dihantar ke mana-mana pelayan, disimpan, atau direkodkan. Anda boleh menggunakannya dengan selamat bersama respons API yang mengandungi kredensial, fail konfigurasi dalaman, atau mana-mana data sensitif.

Apa Itu Penjana JSON Schema?

Penjana JSON Schema mencipta definisi JSON Schema secara automatik daripada data JSON contoh. Daripada menulis definisi skema secara manual, anda tampal JSON anda dan alat ini menyimpulkan jenis, struktur, objek bersarang dan tatasusunan untuk menghasilkan dokumen skema yang sah. Ini menjimatkan berjam-jam kerja manual dan mengurangkan kemungkinan ralat dalam definisi skema anda.

Cara Ia Berfungsi

Penjana menganalisis input JSON anda dan melalui setiap sifat secara rekursif. Ia mengesan jenis data (string, number, integer, boolean, null, object, array), mengenal pasti format rentetan seperti tarikh dan e-mel, dan membina pokok skema yang lengkap. Anda boleh menyesuaikan output dengan pilihan untuk medan wajib, sifat tambahan dan ruang letak penerangan. Semuanya berjalan di sisi klien dalam pelayar anda.

Kes Penggunaan Biasa

Pembangun menggunakan penjana JSON Schema untuk mendokumentasikan API REST, mengesahkan fail konfigurasi, menguatkuasakan kontrak data antara perkhidmatan mikro dan membina pengesah borang. Skema yang dijana daripada respons API sebenar berfungsi sebagai dokumentasi hidup yang boleh diuji secara automatik dalam saluran paip CI. Ia juga penting untuk spesifikasi OpenAPI dan Swagger.

Privasi dan Keselamatan

Penjana JSON Schema ini 100% di sisi klien. Semua penghuraian, penjanaan skema dan pengesahan berlaku dalam pelayar anda menggunakan JavaScript. Tiada data JSON dihantar ke mana-mana pelayan. Tiada kuki menjejaki input anda, dan tiada apa yang disimpan melebihi sesi semasa anda. Selamat untuk API proprietari, konfigurasi dalaman dan data sensitif.

Keselamatan dan Privasi

Keselamatan data anda adalah keutamaan kami

Pemprosesan Tempatan

Semua pemprosesan berlaku dalam pelayar anda

Tiada Pemindahan Data

Data anda tidak dihantar ke pelayan kami

Tiada Penyimpanan Data

Tiada data disimpan atau dikongsi

Penyulitan SSL

Penyulitan SSL untuk sambungan selamat

Adakah alat ini berguna?

Penjana JSON Schema