Generatore di JSON Schema

Cosa fa bene l’inferenza

• Tipi: stringa, numero, intero, booleano, null, array, oggetto.
• Nullabilità: un campo che è null in un campione e una stringa in un altro diventa ["string", "null"].
• Elementi dell’array: gli array omogenei producono uno schema items singolo; gli array eterogenei producono prefixItems.
• Enumerazioni (enum): se tutti i valori osservati provengono da un piccolo insieme (configurabile, predefinito 10 valori distinti), emette un enum.
• Richiesti: con più campioni, l’intersezione delle chiavi diventa richiesta; con un campione, tutte le chiavi sono richieste a meno che tu non decida di escluderle.
• Formati: le stringhe che corrispondono a date ISO-8601, email o URI ottengono un format inferito.

Cosa l’inferenza non può sapere

• Intento vs esempio: un campione age: 25 inferisce type: integer, ma non può sapere che accetti anche null. Passa più campioni che coprano i casi limite.
• Vincoli: minLength, maximum, pattern, devi aggiungerli manualmente. L’inferenza non indovina i limiti dai campioni.
• Logica aziendale: “esattamente uno di questi tre campi deve essere impostato” richiede oneOf, non inferibile.
• Riferimenti: il generatore emette uno schema piatto. Se desideri fattorizzare forme ripetute in $defs, fallo dopo la generazione.

Esempio di output

Da un singolo campione:

{ "name": "Alice", "age": 30, "tags": ["admin", "user"] }

Lo schema inferito (draft 2020-12):

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "integer" },
    "tags": { "type": "array", "items": { "type": "string" } }
  },
  "required": ["name", "age", "tags"]
}

Errori comuni

• Inferire da un campione. Lo schema si adatterà eccessivamente, ogni campo diventa richiesto, senza tolleranza per null. Fornisci sempre almeno 5-10 campioni variati.
• Usare integer quando intendevi number. Se un campione ha un decimale, il tipo inferito diventa number; se tutti sono interi, diventa integer. Per i campi che potrebbero essere entrambi, includi un campione decimale.
• Dimenticare i campi opzionali. Un campo presente in 4 campioni su 5 ma mancante in 1 diventa opzionale, intenzionale. Se tutti e 5 i campioni lo includono, lo schema lo contrassegnerà come richiesto anche se in realtà è opzionale nella tua API.