JSONdokumentit

JSONdokumentit ovat JSON-muodossa esiintyviä dokumentteja, jotka tallentavat ja siirtävät rakenteellista tietoa tekstiin perustuvana muotona. Ne kuvaavat dataa objektien ja taulukoiden muodossa.

JSONdokumentit rakentuvat avain-arvopareista (objektit) ja listauksista (taulukot). Objekteja merkitään aaltosulkeisiin {}, taulukoita hakasulkeisiin []. Avain on merkkijono, ja arvo voi olla merkkijono, numero, totuusarvo, tyhjä-arvo (null) tai näiden sisäkkäisiä objekteja ja taulukkoja. Merkkijonot on kirjoitettava lainausmerkeillä, ja JSONissa ei saa olla lopettimia tai kommentteja standardin mukaan.

JSONdokumentit koodataan UTF-8-merkistöön ja niille on yleisesti käytetty MIME-tyyppi application/json. Eri ohjelmointikielet tarjoavat kirjastoja JSONin jäsentämiseen ja serialisointiin; JavaScript onnistuu suoraan JSON.parse ja JSON.stringify -menetelmillä, mutta myös Python, Java, Go ja monet muut tukevat JSON-käsittelyä.

JSON on kevyt ja ihmisen luettava, ja sitä käytetään laajasti verkkopalveluiden rajapinnoissa, sovellusten konfiguraatioissa ja monissa data-analyysiprosesseissa. Yleisiä käytön muotoja ovat tapahtumalokit sekä JSON Lines (NDJSON), jossa jokainen rivi on itsenäinen JSON-objekti. Suuret binääridatat kannattaa tallentaa erikseen tai koodata base64-ena.

JSON Schema tai vastaavat määrittelevät rakenteen ja validoivat JSONdokumenttien sisältöä, mikä auttaa dokumentaation, validoinnin ja automaattisen testauksen toteuttamista. Vaikkei JSON itsessään määrittele kenttien tyyppejä tai pakollisia arvoja, nämä voivat olla tärkeä osa laadunvarmennusta.