JSON formatter en validator

Zo gebruik je de JSON formatter

Plak je JSON in het linkervak en kies Formatteren. De tool controleert eerst of de tekst geldige JSON is en zet hem daarna netjes onder elkaar, met twee of vier spaties of een tab als inspringing. Met Minify haal je juist alle overbodige spaties en regeleinden weg, zodat je een compacte versie overhoudt voor een configuratiebestand, een testverzoek of een omgevingsvariabele.

Zet Sleutels alfabetisch sorteren aan als je twee API-antwoorden wilt vergelijken. Objecten worden dan op elk niveau op sleutelnaam gesorteerd, terwijl de volgorde binnen arrays gelijk blijft, want die heeft in JSON wel betekenis. Onder het resultaat zie je hoe groot de JSON is, hoeveel sleutels hij bevat en hoe diep de structuur genest is. Dat is handig om snel te zien of een antwoord compleet is of onverwacht groot.

Met Kopiëren zet je het resultaat op je klembord en met Downloaden krijg je een .json-bestand. Alles gebeurt in je browser. Dat maakt de tool geschikt voor data waar je voorzichtig mee wilt zijn, zoals een API-antwoord met klantgegevens of een configuratie met interne adressen.

JSON valideren: fouten vinden met regel en kolom

Een JSON validator vertelt je niet alleen dat er iets mis is, maar ook waar. Gebruikt je API of import een bestand dat niet klopt, dan krijg je vaak alleen een vage melding als "Unexpected token". Deze tool zoekt de fout zelf op en toont het regelnummer, de kolom en het stukje tekst eromheen, met een markering op de regel in het invoervak. Met Ga naar de fout springt je cursor direct naar de juiste plek.

De meeste fouten ontstaan doordat JSON op JavaScript lijkt, maar strenger is. Sleutels moeten altijd tussen dubbele aanhalingstekens staan, enkele aanhalingstekens zijn niet toegestaan en na het laatste element van een object of array mag geen komma staan. Ook commentaar met // of /* */ bestaat in JSON niet, net zomin als undefined, NaN of de Python-schrijfwijze True en None. Herkent de tool zo'n patroon, dan krijg je er een concrete tip bij.

Een fout ligt niet altijd precies op de plek die wordt gemeld. Ontbreekt er een komma of een sluitend haakje, dan merkt de parser dat pas bij het volgende teken. Kijk daarom ook naar de regel erboven. Het fragment in de foutmelding laat om die reden twee regels vóór de fout zien.

Wat is JSON en waarom is opmaak belangrijk?

JSON (JavaScript Object Notation) is het standaardformaat waarmee systemen gegevens uitwisselen. Vrijwel elke moderne API, van je webshop en boekhoudpakket tot een CRM of betaalprovider, stuurt en ontvangt JSON. Het formaat kent maar een paar bouwstenen: objecten met sleutels en waarden, arrays, tekst, getallen, true, false en null. Juist doordat het zo eenvoudig is, kan elke programmeertaal ermee overweg.

Voor een computer maakt opmaak niets uit: geminificeerde en netjes ingesprongen JSON betekenen precies hetzelfde. Voor mensen is het verschil groot. Een API-antwoord van één lange regel is onleesbaar, terwijl je in een opgemaakte versie meteen de structuur ziet: welke velden er zijn, wat er in een lijst zit en waar een waarde ontbreekt. Minify gebruik je juist als bestandsgrootte telt, bijvoorbeeld bij grote hoeveelheden verkeer of beperkte opslagruimte.

Let op met hele grote getallen. JSON zelf kent geen limiet, maar browsers en JavaScript rekenen met getallen tot ongeveer 16 cijfers nauwkeurig. Een ID of rekeningnummer van meer cijfers kan bij formatteren dus net anders terugkomen. Systemen die zulke waarden uitwisselen, versturen ze daarom meestal als tekst.

Van losse JSON naar een betrouwbare koppeling

Een formatter is ideaal om een API-antwoord te bekijken of een configuratie te controleren. Merk je dat je regelmatig JSON uit het ene systeem kopieert, aanpast en in het andere plakt, dan is dat een teken dat een vaste koppeling tijd en fouten bespaart. Een goede integratie valideert de data automatisch tegen een schema, vangt fouten op voordat ze in je administratie belanden en logt wat er misging.

Bij het ontwerpen van zo'n koppeling kijk je naar meer dan het formaat alleen: welke velden verplicht zijn, hoe je omgaat met ontbrekende waarden, wat er gebeurt als een systeem tijdelijk onbereikbaar is en hoe je voorkomt dat een bestelling twee keer wordt verwerkt. Dat zijn de punten waarop handmatig kopiëren en plakken vroeg of laat misgaat.