📋

Generatore JSON Schema

Genera JSON Schema inferendo tipi, proprietà richieste, pattern e strutture annidate. Ideale per API, configurazioni e validazione dei dati.

JSON di input

Opzioni schema

Versione schema
Draft 2020-12 (Latest)

Cos'è un JSON Schema

JSON Schema è uno standard che descrive la struttura e i vincoli di documenti JSON. Permette di validare input, documentare API, generare codice e garantire compatibilità tra servizi. Automatizza la comunicazione dei contratti dati tra team e riduce gli errori runtime.

Funzionalità principali

🧠

Inferenza strutturale

Analizza keys, tipi primitivi, array ed enum deducendo automaticamente pattern e vincoli coerenti.
⚙️

Supporto multi draft

Genera schemi compatibili con Draft-04, Draft-06, Draft-07 e 2020-12, pronti per Ajv, Fastify e altri validator.
🛡️

Opzioni di validazione

Contrassegna campi obbligatori, imposta `additionalProperties`, aggiungi esempi e descrizioni per la documentazione.
📤

Export immediato

Copia o scarica lo schema come file `.schema.json`, integrandolo in OpenAPI, Postman e workflow CI.

📋Guida rapida

1️⃣
Fornisci il campione
Incolla il JSON rappresentativo dell'oggetto che vuoi descrivere. Usa più esempi per una migliore inferenza.
2️⃣
Configura le opzioni
Seleziona la versione JSON Schema, abilita il rilevamento dei campi required e definite se limitare le proprietà addizionali.
3️⃣
Genera e rivedi
Analizza lo schema prodotto, modifica eventuali descrizioni e aggiungi vincoli personalizzati (pattern, min/max).
4️⃣
Esporta per l'uso
Copia o scarica il risultato e integralo nel validator Ajv, nelle definizioni OpenAPI o nei contratti di servizio.

📚Approfondimento tecnico

🧬Inferenza dei tipi

Il parser analizza ogni valore, riconosce `type`, `enum`, `const` e combina i risultati attraverso tutti i campioni forniti.

🧱Gestione array

Identifica array eterogenei e genera `items` con schema combinato (anyOf/allOf) o `contains` quando sono presenti pattern specifici.

🧩Riconoscimento pattern

Dalle stringhe rileva formati comuni (email, uri, date ISO) e propone pattern regex quando il campione è uniforme.

🔗$ref e composizione

Per oggetti ripetuti crea definizioni riutilizzabili inserite in `definitions`/`$defs`, semplificando la manutenzione dello schema.

Domande frequenti

Quanto è accurata l'inferenza automatica?

L'inferenza si basa sui campioni forniti. Più esempi rappresentativi inserisci, più preciso sarà lo schema. Verifica sempre lo schema generato prima di usarlo in produzione.
💬

Posso integrare lo schema in OpenAPI?

Sì, JSON Schema Draft-07 è compatibile con OpenAPI 3.x. Copia lo schema nella sezione `components.schemas` o usa `$ref` per riutilizzarlo.
🔍

Come gestisco campi opzionali?

Disattiva l'opzione required o modifica manualmente l'array `required`. Puoi anche specificare `nullable` o `oneOf` per gestire tipi multipli.
💡

Lo strumento invia dati ai server AnyTools?

No, tutto avviene localmente nel browser. I JSON non vengono trasmessi né salvati, garantendo la riservatezza dei dati.

💡Suggerimenti operativi

🔁

Mantieni esempi aggiornati

Aggiorna il campione JSON ogni volta che l'API evolve per rigenerare lo schema e mantenere i contratti allineati.
🧪

Integra nei test

Valida le risposte utilizzando lo schema generato nelle pipeline CI per intercettare breaking change.
📚

Documenta con descrizioni

Aggiungi descrizioni e esempi per generare automaticamente documentazione leggibile da utenti e partner.
🛡️

Regola additionalProperties

Imposta `additionalProperties: false` per impedire dati imprevisti, oppure definisci schemi secondari per i campi dinamici.

User Comments

0 / 2000
Loading...