Generatore struct Swift → JSON Schema

Input Codice Swift

Caricamento editor…

Output JSON Schema

Impostazioni

Seleziona quale struct/class deve essere trattata come root del JSON Schema.

Il parsing avviene interamente nel tuo browser. Il sorgente non lascia mai la pagina.

Incolla i tuoi modelli Swift per produrre JSON Schema istantaneamente.

Supporta struct Codable, tipi optional, array, dizionari e modelli annidati.

Come convertire struct Swift in JSON Schema – guida passo‑passo

Questo convertitore online struct Swift → JSON Schema ti aiuta a generare JSON Schema da modelli reali (DTO, struct e classi) per validare payload, condividere contratti e generare JSON mock.

  1. Passo 1 – Incolla il sorgente Swift

    • Incolla i modelli che vuoi documentare nell’editor di sinistra.
    • Includi i tipi referenziati nello stesso snippet in modo che lo schema possa generare le definizioni.
    • Usa il pulsante Esempio per caricare un esempio e vedere il formato atteso.
  2. Passo 2 – Seleziona il Tipo root (se necessario)

    • Se vengono rilevate più definizioni, scegli la root che corrisponde al payload della tua API.
    • Lo schema di output è costruito attorno alla root selezionata e può includere definizioni aggiuntive per i tipi referenziati.
  3. Passo 3 – Controlla l’output JSON Schema

    • Verifica tipi, campi richiesti vs opzionali e strutture annidate di oggetti/array.
    • Cerca definitions e $ref quando i tuoi modelli fanno riferimento ad altri modelli.
    • Copia o scarica lo schema per validazione, documentazione o sviluppo schema‑first.
  4. Passo 4 – Valida o genera JSON mock

    • Fai clic su Genera dati mock per aprire il generatore di mock con lo schema pre‑caricato.
    • Valida payload reali rispetto allo schema per intercettare breaking change in anticipo.
    • Se usi composizione avanzata dello schema (ad esempio anyOf/oneOf/allOf), verifica il risultato con un validatore completo come Ajv.

Nota sul supporto delle keyword dello schema

Gli schemi generati possono includere $ref e possono essere modificati per includere anyOf, oneOf, o allOf. Per schemi complessi, usa un validatore JSON Schema completo e dereferenzia prima della generazione dei mock se necessario.

Strumenti correlati per JSON Schema e generazione di codice

Usa questi strumenti per validare schemi, generare payload mock, formattare esempi JSON e mantenere allineati codice e contratti.

Domande frequenti

Quali tipi Swift sono supportati?

Lo strumento parserizza struct e classi con stored properties. Gestisce tipi optional (String?), array, dizionari, valori di default, annotazioni Codable come @CodingKey (ignorate ma sicure) e tipi annidati. Incolla modelli direttamente dal tuo progetto Swift o SwiftUI.

Come vengono mappati i tipi Swift su JSON Schema?

String/Int/Double/Bool mappano ai primitivi dello schema, array come [Address] diventano array schema, i dizionari diventano oggetti e i tipi optional diventano campi opzionali. Tipi custom sconosciuti ricadono su string a meno che non esista un’altra struct/class con lo stesso nome nell’input.

Posso includere più struct?

Sì. Incolla più struct correlate e scegli il tipo root dal menu impostazioni. Tutto gira localmente nel browser, quindi nessun sorgente viene caricato.

Come creo dati JSON mock?

Dopo aver generato lo schema, fai clic su "Genera dati mock" per aprire il Mock Generator con lo schema pre‑caricato. Configura locale, numero elementi array e campi opzionali per creare subito payload di esempio.

Generatore struct Swift → JSON Schema | JSONSwiss