JSON formatter i validator

Šta je JSON i čemu služi formatter

JSON (JavaScript Object Notation) je tekstualni format za razmenu podataka. Nastao je iz JavaScript sintakse, ali ga danas podržava praktično svaki programski jezik, pa je postao standard za API odgovore, konfiguracione fajlove i prenos podataka između servisa. Njegova prednost je što je čitljiv i ljudima i mašinama, za razliku od binarnih formata.

Formatter radi dve stvari. Prvo, "lepo" formatira JSON tako što uvodi uvlačenja i prelome redova, pa se struktura vidi na prvi pogled. Drugo, minifikuje ga uklanjanjem svih suvišnih razmaka, što je korisno kada se JSON šalje preko mreže ili upisuje u bazu. Validator uz to proverava da li je tekst uopšte ispravan JSON prema specifikaciji.

Tipičan primer: API vrati jednu dugačku liniju sa stotinama polja. Nalepite je u formatter i dobijete uredno uvučeno stablo objekata i nizova, gde odmah vidite gde se nalazi koje polje.

Zašto moj JSON nije ispravan i kako to popraviti

Većina grešaka u JSON-u je sintaksna i ponavlja se iznova. JSON je stroži od JavaScript objekata, pa ono što radi u kodu često ne prolazi validaciju.

1. Zarez posle poslednjeg elementa. {"a": 1, "b": 2,} nije ispravan JSON, iako ga mnogi parseri u JavaScript-u tolerišu. Uklonite taj zarez.
2. Jednostruki navodnici. Ključevi i string vrednosti moraju biti pod dvostrukim navodnicima. {'ime': 'Ana'} je neispravno, {"ime": "Ana"} je ispravno.
3. Ključevi bez navodnika. {ime: "Ana"} nije JSON. Svaki ključ mora biti string.
4. Komentari. JSON ne podržava // ni /* */. Ako vam treba dokumentacija unutar podataka, koristite posebno polje, na primer "_komentar".
5. Nevalidne vrednosti. NaN, Infinity i undefined ne postoje u JSON-u. Umesto njih koristite null ili string.
6. Neuparene zagrade i nedostajući navodnik. Validator obično prijavi tačnu liniju i kolonu, pa krenite od prve prijavljene greške, jer ostale mogu biti samo posledica.

Praktičan savet: kada nešto ne radi, prvo proverite da li je problem u podacima ili u kodu koji ih čita. Formatter vam to razdvaja u nekoliko sekundi.

Kako formatirati i minifikovati JSON bezbedno

Ako JSON sadrži osetljive podatke, na primer tokene, lične podatke ili konfiguraciju sa lozinkama, proverite gde se obrada dešava. Alat na evi.rs radi u vašem pregledaču, pa sadržaj ne napušta računar. To je važno kada radite sa produkcionim podacima ili podacima klijenata.

Kada minifikujete JSON, imajte na umu da se time menja samo prikaz, ne i značenje. Minifikovana verzija je pogodna za slanje, ali je loša za ručno pregledanje i code review. U praksi je korisno čuvati formatiranu verziju u repozitorijumu, a minifikovanu generisati u toku build-a ili slanja.

Strukturisani JSON i rad sa AI modelima

Kada AI model treba da vrati podatke koje sistem dalje obrađuje, najpouzdaniji pristup je da izlaz bude strogo strukturisan JSON. Model tada popunjava unapred definisanu šemu, a vi taj izlaz proverite validatorom pre nego što uđe u bazu ili dalju obradu. Time se izbegava ručno parsiranje slobodnog teksta i greške koje iz toga nastaju.

Napredni savet: definišite šemu sa obaveznim poljima i tipovima, pa validirajte ne samo sintaksu nego i strukturu. JSON može biti sintaksno ispravan, a da mu nedostaje polje koje očekujete. Za takve provere koristite JSON Schema validatore, a ovaj alat za brzu proveru sintakse i čitljivost.

Ako integracije, automatizacije i obrada podataka prerastu pojedinačne alate, EVI Solutions može pomoći oko arhitekture i povezivanja sistema.