Generator Swift Struct ke JSON Schema

Input Kode Swift

Memuat editor…

Output JSON Schema

Pengaturan

Pilih struct/class yang harus diperlakukan sebagai root JSON Schema.

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

Tempel model Swift Anda untuk menghasilkan JSON Schema secara instan.

Mendukung Codable struct, tipe optional, array, dictionary, dan model bersarang.

Cara mengonversi struct Swift menjadi JSON Schema – panduan langkah demi langkah

Konverter struct Swift 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 Swift 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 Tipe 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

Tipe Swift apa yang didukung?

Alat ini mem-parsing struct dan class dengan stored properties. Mendukung tipe optional (String?), array, dictionary, nilai default, anotasi Codable seperti @CodingKey (diabaikan tetapi aman), dan tipe bersarang. Tempel model langsung dari proyek Swift atau SwiftUI Anda.

Bagaimana tipe Swift dipetakan ke JSON Schema?

String/Int/Double/Bool dipetakan ke primitif schema, array seperti [Address] menjadi schema array, dictionary menjadi objek, dan tipe optional menjadi field opsional. Tipe kustom yang tidak dikenal fallback ke string kecuali ada struct/class lain dengan nama yang sama dalam input.

Bisakah saya menyertakan beberapa struct?

Ya. Tempel beberapa struct yang saling terkait dan pilih tipe root dari dropdown pengaturan. Semua berjalan lokal di browser, sehingga tidak ada source code yang diunggah.

Bagaimana membuat data JSON mock?

Setelah schema dibuat, klik "Buat Data Mock" untuk membuka Mock Generator dengan schema Anda yang sudah dimuat. Konfigurasikan locale, jumlah array, dan field opsional untuk membuat payload contoh secara instan.

Generator Swift Struct ke JSON Schema | JSONSwiss