Input JSON

Schema generato

Cos'è un Generator di Schema JSON?

Uno Schema JSON descrive la struttura di un documento JSON: quali campi esistono, i loro tipi e quali sono obbligatori. Questo narzedzie analizza il tuo JSON e genera automaticamente uno schema corrispondente. Prende il tuo JSON come input ed emette uno schema valido che puoi usare per la validazione, la documentazione o la generazione di codice.

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 narzedzie

Incolla o carica JSON

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

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.

Kopiuj o scarica

Usa <strong>Kopiuj</strong> o <strong>Pobierz</strong> per ottenere lo schema. Per validare JSON rispetto allo schema, usa il Walidator JSON o una libreria come <a href="https://ajv.js.org/" target="_blank" rel="noopener">Ajv</a>.

Przyklady Schema JSON

Generazione di uno schema da un JSON di esempio. Przyklad 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 dane 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, narzedzia come OpenAPI possono fare riferimento agli schemi JSON.

czesto zadawane pytania

Posso usare questo schema per validare JSON?

Questo narzedzie genera solo lo schema. Per validare, usa il Walidator 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 dane vengono inviati da qualche parte?

Nie. La generazione viene eseguita nel browser.

Quale bozza di JSON Schema viene usata?

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

powiazane narzedzia

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.