A scrie o schemă de la zero e migălos. A o genera dintr-un exemplu real durează secunde. Acest instrument construiește o JSON Schema (draft-07) dintr-un exemplu JSON, prin inferența tipurilor, direct în browserul tău – gata de rafinat și folosit.
Ce este JSON Schema
JSON Schema este un standard prin care descrii formal structura așteptată a unor date JSON: ce câmpuri există, cu ce tip și care sunt obligatorii. Cu o schemă poți valida automat datele de intrare (respectă formatul?) și le poți documenta clar, citibil de mașină.
Cum funcționează inferența
Instrumentul parcurge exemplul și deduce tipul fiecărei valori:
| Valoare exemplu | Tip schemă |
|---|---|
42 | integer |
3.14 | number |
"text" | string |
true | boolean |
{ … } | object (cu properties) |
[ … ] | array (items din primul element) |
Pentru obiecte, generează lista properties; pentru tablouri, deduce tipul elementelor din primul element.
De ce totul e obligatoriu implicit
Dintr-un singur exemplu nu se poate ști care câmpuri sunt opționale – exemplul le conține pur și simplu pe cele prezente. De aceea valoarea implicită sigură e ca fiecare câmp observat să fie marcat required. Cu comutatorul dezactivezi asta, dacă vrei o schemă mai permisivă, care nu impune prezența câmpurilor.
Un punct de plecare, nu produsul final
Schema generată e un schelet excelent, dar merită rafinată manual:
- Marchează câmpurile cu adevărat opționale.
- Adaugă limite (
minLength,maximum,pattern). - Definește
enumpentru valorile permise. - Descrie câmpurile cu
description.
Astfel treci în câteva minute de la date brute la o schemă riguroasă.
Cum se folosește
- Lipește un exemplu reprezentativ de date JSON.
- Decide dacă fiecare câmp să fie obligatoriu.
- Citește schema draft-07 generată.
- Copiaz-o pentru validare sau documentare.
Cazuri de utilizare
- Validare – verificarea datelor de intrare pe baza schemei.
- Documentare – descrierea formală a unui API.
- Contract API – bază comună între backend și frontend.
- Testare – generarea de date valide și invalide.
Confidențialitate: totul rămâne local
Generarea rulează în browserul tău, prin JavaScript. Datele exemplu nu ajung pe niciun server – poți lucra în siguranță și cu structuri interne.
Instrumente înrudite
- Vizualizator JSON — arbore restrângibil pentru JSON
- Convertor JSON ↔ XML — conversie bidirecțională
- Validare JSON — verificarea sintaxei JSON
- Formatare JSON — beautify și minify JSON