Generator C# Class ke JSON Schema

Input Kode C#

Memuat editor…

Output JSON Schema

Pengaturan

Pilih class atau record yang harus diperlakukan sebagai root saat membuat schema.

Parsing berjalan sepenuhnya di browser Anda. Sumber Anda tidak pernah meninggalkan halaman.

Tempel DTO C# Anda untuk menghasilkan JSON Schema secara instan.

Mendukung class, struct, record, anotasi, nullable reference types, dan koleksi generik.

Cara mengonversi class dan record C# menjadi JSON Schema – panduan langkah demi langkah

Konverter class C# ke JSON Schema online ini membantu Anda menghasilkan JSON Schema dari model nyata (DTO, struct, dan class) sehingga Anda dapat memvalidasi payload, membagikan kontrak, dan membuat JSON mock.

  1. Langkah 1 – Tempel sumber C# Anda

    • Tempel model yang ingin Anda dokumentasikan ke editor kiri.
    • Sertakan tipe yang direferensikan dalam snippet yang sama agar schema dapat menghasilkan definitions.
    • Gunakan tombol Contoh untuk memuat contoh dan melihat format input yang diharapkan.
  2. Langkah 2 – Pilih Class root (jika perlu)

    • Jika beberapa definisi terdeteksi, pilih root yang cocok dengan payload API Anda.
    • Output schema dibangun berdasarkan root yang dipilih dan dapat menyertakan definisi tambahan untuk tipe yang direferensikan.
  3. Langkah 3 – Tinjau output JSON Schema

    • Periksa tipe, field wajib vs opsional, serta struktur objek/array bersarang.
    • Cari definitions dan $ref saat model Anda mereferensikan model lain.
    • Salin atau unduh schema untuk validasi, dokumentasi, atau pengembangan schema-first.
  4. Langkah 4 – Validasi atau buat JSON mock

    • Klik Buat Data Mock untuk membuka mock generator dengan schema Anda yang sudah dimuat.
    • Validasi payload nyata terhadap schema untuk menangkap breaking change lebih awal.
    • Jika Anda mengandalkan komposisi schema lanjutan (misalnya anyOf/oneOf/allOf), verifikasi hasilnya dengan validator penuh seperti Ajv.

Catatan dukungan keyword schema

Schema yang dihasilkan dapat menyertakan $ref dan bisa diedit untuk menyertakan anyOf, oneOf, atau allOf. Untuk schema yang kompleks, gunakan validator JSON Schema penuh dan lakukan dereference sebelum membuat mock jika diperlukan.

Alat JSON Schema & pembuatan kode terkait

Gunakan alat-alat ini untuk memvalidasi schema, menghasilkan payload mock, memformat contoh JSON, dan menjaga sinkronisasi kode serta kontrak.

Pertanyaan yang Sering Diajukan

Konstruk C# apa yang didukung?

Parser memahami class, struct, record (dengan primary constructor), auto-property, backing field, enum, serta atribut seperti JsonPropertyName, JsonProperty, dan DataMember(Name=...). Parser menghormati nullable reference types, field opsional, collection, dan dictionary langsung di schema yang dihasilkan.

Bagaimana tipe dipetakan ke JSON Schema?

Tipe primitif seperti string, bool, int/double/decimal, DateTime/DateOnly/Guid dipetakan ke tipe dan format schema terdekat. Array, List<T>, IEnumerable<T>, Dictionary<TKey, TValue>, Nullable<T>, dan T? dikonversi menjadi konstruksi array/object/opsional pada schema. Simbol yang tidak dikenali akan fallback ke reference jika cocok dengan class atau enum lain yang terdeteksi.

Apakah bekerja dengan versi C# dan serializer yang berbeda?

Ya. Fitur modern seperti records, init-only setter, nullable reference types, anotasi System.Text.Json, dan atribut klasik Newtonsoft.Json didukung. Alat ini berjalan sepenuhnya di browser, sehingga Anda aman menempel DTO proprietary atau kontrak API.

Bagaimana saya dapat membuat JSON mock?

Setelah schema dibuat, klik "Buat Data Mock" untuk membuka Mock Generator dengan schema yang sudah dimuat. Konfigurasikan locale, jumlah array, dan field opsional untuk menghasilkan payload realistis untuk dokumentasi atau tes.

Generator C# Class ke JSON Schema | JSONSwiss