# Generatore di schemi JSON

Generate uno schema JSON da un campione JSON. Il generatore deduce i tipi, le proprietà obbligatorie, gli schemi degli elementi degli array e i formati di stringa comuni come date-time, email, uri e uuid, quindi produce uno schema per la bozza 2020-12, 2019-09 o draft-07, da usare per convalidare richieste, documentare un’API o generare moduli.

## Domande frequenti

### Quali bozze di schema JSON sono supportate?

La bozza 2020-12, la versione attuale usata da OpenAPI 3.1, la bozza 2019-09 e draft-07, ancora richieste da molti validatori e strumenti meno recenti. La scelta imposta il $schema URL; le parole chiave scritte dal generatore hanno lo stesso significato in tutte e tre.

### Come vengono determinate le proprietà obbligatorie?

Una proprietà viene elencata tra quelle obbligatorie quando compare in ogni campione di quell’oggetto. In un array di oggetti, una chiave che manca in alcuni elementi non viene inclusa tra quelle obbligatorie. Disattivate l’opzione per generare uno schema senza elenchi di proprietà obbligatorie.

### Quali formati di stringa vengono rilevati?

date-time, date, time, email, uri, uuid e ipv4. Un formato viene aggiunto solo se tutti i valori campione di quella proprietà corrispondono; basta un valore di testo libero perché la proprietà resti una normale stringa. Disattivate il rilevamento se non volete parole chiave di formato.

### Lo schema distingue gli interi dai decimali?

Sì. Una proprietà i cui campioni sono tutti numeri interi riceve il tipo integer. Se anche un solo campione ha una parte frazionaria, il tipo diventa number, che accetta anche gli interi.

### Come vengono descritti gli array?

A un array viene assegnato il tipo array e uno schema items costruito considerando insieme tutti i suoi elementi. Gli oggetti in un array vengono uniti, così lo schema degli elementi elenca tutte le chiavi presenti in almeno un elemento; tra le proprietà obbligatorie rientrano solo quelle presenti in tutti.

### Che succede con i tipi misti?

Quando una proprietà contiene valori semplici di tipi diversi, per esempio una stringa in un elemento e null in un altro, lo schema li elenca come array di tipi, per esempio ["string", "null"]. Quando gli oggetti o gli array sono mescolati ad altri tipi, il generatore usa anyOf con uno schema per ciascun tipo.

### Vengono aggiunti additionalProperties o dei limiti?

No. Un campione non può indicare quali chiavi aggiuntive siano vietate né quali siano i valori minimi e massimi effettivi, quindi il generatore omette additionalProperties, minLength, maximum e parole chiave simili. Aggiungetele a mano quando i vostri dati lo richiedono.

### Posso convalidare i dati con il risultato?

Sì. Incollate lo schema e i vostri dati nel validatore di schemi JSON oppure usatelo con una libreria come Ajv. Controllate prima lo schema: rispecchia il campione, quindi se nei dati reali un campo può mancare o essere null ma nel campione non accade, dovrete apportare una piccola modifica.

### Posso usare lo schema in OpenAPI?

OpenAPI 3.1 usa direttamente lo schema JSON Schema 2020-12, quindi lo schema generato può essere inserito in components/schemas dopo aver rimosso la riga $schema. OpenAPI 3.0 usa un sottoinsieme meno recente; in quel caso, sostituite gli array di tipo con nullable.

### Qual è la dimensione massima dell'input?

Fino a 1,000,000 caratteri di JSON, con annidamento fino a 64 livelli. Il campione viene analizzato solo per questa richiesta e non viene salvato.

Il tuo annuncio qui?

[Scrivici](mailto:hi@dennn.is?subject=Pubblicit%C3%A0%20su%20OneClick%20Pro)

[Annuncio 433 strumenti per i vostri agenti IA tramite un unico server MCP.](https://multitaskai.com/it/?ref=oneclickpro)
