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.
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.
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.
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.
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.