Generatore di Schema JSON

Genera automaticamente uno Schema JSON dai dati JSON

Input JSON

Schema generato

Cos'è un Generatore di Schema JSON?

Hai mai dovuto scrivere un JSON Schema a mano da zero? È noioso. Questo strumento lo fa per te — incolla un oggetto JSON di esempio e genera istantaneamente uno schema che descrive quella struttura: tipi, proprietà, campi obbligatori e oggetti annidati. Lo schema generato segue le convenzioni JSON di RFC 8259 ed è compatibile con strumenti come Ajv. Usalo per avviare la documentazione delle API, validare pipeline di dati o creare schemi per specifiche OpenAPI.

La generazione avviene nel tuo browser. Niente viene inviato a un server. Lo schema generato è un punto di partenza — potresti aver bisogno di modificarlo per aggiungere vincoli, campi obbligatori o valori enum.

Come usare questo strumento

1

Incolla o carica JSON

Incolla il JSON che vuoi descrivere nell'editor. Usa Esempio o Carica se necessario. Il generatore inferisce i tipi dai valori (string, number, boolean, array, object).

2

Rivedi lo schema

Il pannello di destra mostra lo schema generato. Può includere type, properties, required e schemi annidati per gli oggetti. Puoi modificarlo manualmente se necessario.

3

Copia o scarica

Usa Copia o Scarica per ottenere lo schema. Per validare JSON rispetto allo schema, usa il Validatore JSON o una libreria come Ajv.

Esempi di Schema JSON

Generazione di uno schema da un JSON di esempio. Esempio con tema telecomunicazioni:

Input JSON

Input

Schema generato

Output

Quando usare lo schema generato

Lo schema generato è un punto di partenza. Cattura la struttura dei dati di esempio ma potrebbe essere troppo rigido o troppo permissivo. Potrebbe essere necessario aggiungere array required, regolare i tipi o aggiungere enum per i valori consentiti. La documentazione di JSON Schema spiega il vocabolario completo. Per la documentazione delle API, strumenti come OpenAPI possono fare riferimento agli schemi JSON.

Esempio: Genera uno schema da un oggetto utente

Input JSON:

{
  "id": 1,
  "name": "Alice",
  "email": "[email protected]",
  "age": 30,
  "active": true
}

JSON Schema generato:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "id": { "type": "integer" },
    "name": { "type": "string" },
    "email": { "type": "string" },
    "age": { "type": "integer" },
    "active": { "type": "boolean" }
  }
}

Domande frequenti

Posso usare questo schema per validare JSON?

Questo strumento genera solo lo schema. Per validare, usa il Validatore JSON o una libreria come Ajv nel tuo codice.

E se il mio JSON ha forme diverse?

Il generatore inferisce dal campione che fornisci. Se il tuo JSON può avere più forme (es. campi opzionali), lo schema potrebbe richiedere modifiche manuali. Usa oneOf o anyOf per le varianti.

I dati vengono inviati da qualche parte?

No. La generazione viene eseguita nel browser.

Quale bozza di JSON Schema viene usata?

Lo strumento può usare draft-07 o draft-2020-12. Controlla il $schema nello schema generato per verificare la versione. La specifica JSON Schema ha i dettagli.

Posso usarlo per le risposte API?

Sì. Incolla una risposta API tipica. Lo schema generato descriverà quella struttura. Puoi poi usarlo in OpenAPI/Swagger o per la documentazione.

Strumenti correlati

Formattatore JSON Validatore JSON JSON Minifier Unisci JSON JSON a CSV JSON a TypeScript JSON Escape

Scopri di più su json-schema.org e JSON Schema Learn. Per la validazione nel codice, vedi Ajv. Per JSON: json.org, MDN, RFC 8259. Per la documentazione API: OpenAPI.