Wat is JSON?
JSON staat voor JavaScript Object Notation. Het is een lichtgewicht tekstformaat om data gestructureerd op te slaan en uit te wisselen. Leesbaar voor mensen en machines.
JSON is ontstaan als onderdeel van JavaScript, maar wordt vandaag overal gebruikt: in webapplicaties, API's, configuratiebestanden, AI-tools en zelfs in spreadsheets. Het is de universele taal waarmee systemen data met elkaar delen.
Een JSON-bestand is simpelweg een tekstbestand met de extensie .json. Je kunt het openen in elke teksteditor, en de structuur is zo eenvoudig dat je het na vijf minuten kunt lezen en schrijven.
In het kort: JSON = gestructureerde data als tekst. Het werkt overal, je hebt geen speciale software nodig, en zowel mensen als computers begrijpen het.
De bouwstenen van JSON
JSON kent slechts een paar bouwstenen. Objecten (met accolades) bevatten sleutel-waardeparen. Arrays (met vierkante haken) bevatten lijsten van waarden. Waarden kunnen tekst, getallen, booleans (true/false), null, objecten of arrays zijn. Meer is er niet.
Een simpel voorbeeld
Stel dat je de gegevens van een klant wil opslaan. In JSON ziet dat er zo uit: een object met velden zoals "naam", "email", "bedrijf" en "orders". Elk veld heeft een duidelijke naam en een waarde. Orders kan een lijst zijn van meerdere items, elk met hun eigen velden.
Dit is het grote voordeel van JSON: het is hierarchisch. Je kunt data nesten, groeperen en structureren op een manier die logisch is voor jouw toepassing.
Waarom JSON in plaats van een database?
Een database is krachtig maar complex. Voor veel toepassingen is JSON eenvoudiger, sneller en meer dan voldoende.
Geen installatie nodig
Een database vereist server-software, configuratie, onderhoud en vaak ook kosten. Een JSON-bestand is een simpel tekstbestand dat je overal kunt openen. Geen MySQL, geen PostgreSQL, geen hosting nodig.
Leesbaar en bewerkbaar
Je kunt een JSON-bestand openen in Notepad, VS Code of elke andere teksteditor. Probeer dat maar eens met een database-bestand. JSON is direct leesbaar, wat het ideaal maakt voor configuraties, templates en kleine datasets.
Perfect voor kleine tot middelgrote datasets
Heb je een lijst van 10 klanten, 50 producten of 200 orders? JSON handelt dat moeiteloos af. Pas bij duizenden records met complexe relaties wordt een database echt nodig.
Wanneer kies je wel voor een database?
| JSON is ideaal voor | Database is beter voor |
|---|---|
| Configuratiebestanden | Duizenden gelijktijdige gebruikers |
| Kleine lijsten en datasets | Complexe relaties tussen tabellen |
| Data-uitwisseling tussen tools | Real-time transacties |
| Prototypes en experimenten | Geavanceerde zoekopdrachten |
| AI-prompts en templates | Beveiliging en toegangscontrole |
De vuistregel: Als je data in een spreadsheet zou bijhouden, dan kun je het waarschijnlijk ook in JSON doen. Pas als je Excel-achtige functies, formules of meerdere gelijktijdige gebruikers nodig hebt, overweeg je een database.
JSON in de praktijk: structuur en syntax
De spelregels van JSON zijn eenvoudig. Hier leer je de syntax en de meest voorkomende patronen.
De basisregels
Een object bevat sleutel-waardeparen tussen accolades. Elke sleutel staat tussen aanhalingstekens, gevolgd door een dubbele punt en de waarde. Paren worden gescheiden door een komma.
Een array is een geordende lijst van waarden tussen vierkante haken. Waarden worden gescheiden door komma's. Een array kan tekst, getallen, objecten of andere arrays bevatten.
Tekst staat altijd tussen dubbele aanhalingstekens. Getallen staan zonder aanhalingstekens. Booleans zijn true of false (zonder aanhalingstekens). Null geeft een lege waarde aan.
Veelgemaakte fouten
De meest voorkomende fout in JSON is een ontbrekende of extra komma. Na het laatste item in een object of array mag geen komma staan. Andere veelgemaakte fouten: enkele aanhalingstekens gebruiken (JSON vereist dubbele), of commentaar toevoegen (JSON ondersteunt geen commentaar).
Tip: Gebruik een JSON-validator zoals jsonlint.com om je bestanden te controleren. Of vraag Claude: "Controleer of deze JSON geldig is." Claude vindt fouten direct en legt uit wat er mis is.
Data opslaan in JSON-bestanden
Van configuratie tot klantgegevens: praktische patronen voor het opslaan van data in JSON.
Configuratiebestanden
Een van de meest voorkomende toepassingen van JSON is het opslaan van instellingen. Denk aan de kleuren van je huisstijl, de teksten op je website, of de parameters voor een AI-tool. Je slaat ze op in een .json-bestand en leest ze in wanneer nodig.
Het voordeel: als je een kleur wil aanpassen, wijzig je een waarde in het JSON-bestand. Je hoeft niet in de code te duiken. Dit scheidt configuratie van functionaliteit.
Lijsten en collecties
JSON is perfect voor het bijhouden van lijsten: producten, klanten, orders, taken, evenementen. Elke lijst is een array van objecten, waarbij elk object dezelfde structuur heeft. Dit maakt het makkelijk om items toe te voegen, te bewerken of te verwijderen.
Hierarchische data
Wat JSON onderscheidt van een simpele CSV is de mogelijkheid om data te nesten. Een klant kan meerdere contactpersonen hebben, elk met hun eigen telefoonnummers. Een order kan meerdere regels bevatten, elk met een product, aantal en prijs. Deze hierarchie is in CSV moeilijk, in JSON natuurlijk.
Praktisch: Bewaar je JSON-bestanden samen met je project in een duidelijke mappenstructuur. Gebruik namen als config.json, klanten.json of orders.json. Zo weet iedereen direct wat erin staat.
Voorbeeld: huisstijl opslaan
Sla de volledige visuele identiteit van je bedrijf op in een JSON-bestand: primaire kleur, secundaire kleuren, lettertype, logo-pad en standaardteksten. Geef dit bestand mee aan Claude bij elk project en je ontwerpen zijn altijd consistent.
Data uitwisselen tussen systemen
JSON is de standaardtaal voor datacommunicatie. Bijna elke API, webhook en integratietool spreekt JSON.
API's en webhooks
Wanneer twee systemen data uitwisselen, doen ze dat vrijwel altijd in JSON. Jouw webshop stuurt een order naar je boekhoudsoftware in JSON. Je website ontvangt contactformulier-inzendingen als JSON. Een webhook van een betaalprovider stuurt betalingsbevestigingen in JSON.
Dit maakt JSON essentieel voor iedereen die systemen aan elkaar koppelt, of dat nu via tools als n8n, Zapier of handmatig via code is.
Importeren en exporteren
Veel tools ondersteunen JSON-import en -export. Je kunt data uit een spreadsheet exporteren naar JSON, die verwerken met een script of AI, en weer importeren in een ander systeem. Dit is een krachtige manier om data te transformeren zonder een database.
Orderdata als JSON versturen naar je boekhoudpakket. Klantnaam, artikelen, bedragen en BTW in een gestructureerd formaat.
Contactformulier-inzendingen als JSON doorsturen naar je CRM-systeem. Naam, email, bericht en datum netjes gestructureerd.
Spreadsheet-data omzetten naar JSON en meegeven aan Claude voor analyse, rapportage of transformatie.
Projectinstellingen als JSON-bestand delen met teamleden. Iedereen werkt met dezelfde kleuren, teksten en parameters.
Tip: Vraag Claude om data te converteren. "Zet deze Excel-tabel om naar JSON" of "Maak van deze klantgegevens een JSON-bestand" werkt feilloos. Claude begrijpt de structuur en maakt een correct bestand.
JSON en AI: slimme combinaties
JSON en AI-tools zijn een perfecte combinatie. AI begrijpt JSON, genereert het en verwerkt het moeiteloos.
Gestructureerde output van AI
Een van de krachtigste toepassingen: vraag Claude om antwoorden te geven in JSON-formaat. In plaats van een lap tekst krijg je gestructureerde data die je direct kunt gebruiken in je applicatie, dashboard of workflow.
Voorbeeld: "Analyseer deze klantenlijst en geef per klant een samenvatting in JSON met de velden: naam, sector, omzet_categorie en aanbeveling." Je krijgt een array van objecten die je direct kunt importeren.
JSON als input voor AI
Geef Claude een JSON-bestand als context en stel er vragen over. "Welke klant heeft de hoogste omzet?" of "Maak een samenvatting van alle orders van deze week." Claude leest de structuur en geeft gerichte antwoorden.
MCP en JSON
Het Model Context Protocol (MCP) communiceert volledig in JSON. Elke tool-aanroep, elk resultaat en elke configuratie is een JSON-object. Als je MCP-servers bouwt of gebruikt, is JSON-kennis onmisbaar.
Krachtige combinatie: Gebruik JSON als de schakel tussen je data, je AI-tools en je applicaties. Exporteer data als JSON, laat AI het verwerken, en importeer het resultaat weer in je systeem. Dit is de kern van moderne AI-workflows.
Praktisch voorbeeld
Je hebt een spreadsheet met productgegevens. Exporteer die als JSON, geef het aan Claude met de opdracht "Schrijf voor elk product een wervende productbeschrijving in het Nederlands." Claude levert een nieuw JSON-bestand met dezelfde structuur plus de beschrijvingen. Import dit in je webshop. Klaar.
JSON in AI-workflows: voorbeelden
Concrete scenario's waarin JSON de brug vormt tussen je data en AI-toepassingen.
Sla herbruikbare prompts op als JSON met variabelen. Claude vult de variabelen in op basis van je input. Ideaal voor standaarddocumenten.
Haal data op als JSON, laat Claude analyseren en samenvatten, en genereer een PDF-rapport. De hele keten draait op JSON als dataformaat.
Een JSON-bestand met teksten in het Nederlands. Claude vertaalt elk veld naar Frans, Duits en Engels. Je krijgt een JSON terug per taal.
Plan je social media posts in JSON: datum, platform, tekst en afbeelding. Claude genereert de teksten, jij plant ze in.
JSON Schema: structuur afdwingen
Als je werkt met grote hoeveelheden data of meerdere teamleden, wil je afdwingen dat JSON-bestanden een vaste structuur volgen. JSON Schema is een standaard waarmee je definieert welke velden verplicht zijn, welke datatypes geldig zijn en welke waarden zijn toegestaan.
Vraag Claude om een JSON Schema te genereren op basis van een voorbeeld. Claude analyseert de structuur en maakt een schema dat je kunt gebruiken om toekomstige bestanden te valideren. Dit voorkomt fouten en inconsistenties.
Pro tip: Geef Claude altijd een voorbeeld van de gewenste JSON-structuur bij je opdracht. Dit werkt als een schema en zorgt ervoor dat de output exact het formaat heeft dat je nodig hebt.
Tips, valkuilen en best practices
Voorkom veelgemaakte fouten en werk efficienter met JSON dankzij deze praktische richtlijnen.
Do's
Kies een stijl voor je sleutels (camelCase of snake_case) en houd die aan. Meng geen stijlen binnen hetzelfde bestand. Dit maakt je data voorspelbaar.
Gebruik een validator of vraag Claude om je bestand te controleren voordat je het in productie gebruikt. Een ontbrekende komma kan een heel systeem laten crashen.
Bewaar niet alles in een groot bestand. Splits data op in logische bestanden: klanten.json, producten.json, config.json. Dit maakt onderhoud eenvoudiger.
Don'ts
Wachtwoorden, API-sleutels en persoonsgegevens horen niet in platte JSON-bestanden. Gebruik omgevingsvariabelen of een beveiligde vault voor gevoelige data.
Een JSON-bestand is een gewoon bestand. Als je het per ongeluk overschrijft of verwijdert, is je data weg. Gebruik versiebeheer (Git) of maak regelmatig kopieen.
Geavanceerde technieken
Als je de basis beheerst, kun je JSON inzetten voor complexere scenario's en workflows.
JSON als tussenformaat
Gebruik JSON als de schakel in een datapipeline. Haal ruwe data op uit een bron (Excel, API, formulier), converteer het naar JSON, verwerk het met AI of een script, en stuur het resultaat door naar de bestemming. JSON is lichtgewicht genoeg om snel te verwerken en gestructureerd genoeg om betrouwbaar te zijn.
Meerdere bestanden combineren
In plaats van alles in een database te stoppen, kun je werken met meerdere JSON-bestanden die naar elkaar verwijzen via ID's. Klanten.json bevat klantgegevens met een uniek klant-ID. Orders.json verwijst naar dat klant-ID. Dit is een eenvoudige vorm van relationele data zonder database.
JSON en versiebeheer
Omdat JSON platte tekst is, werkt het perfect met Git. Elke wijziging in je data is zichtbaar als een diff. Je kunt terug naar eerdere versies, wijzigingen vergelijken en samenwerken met collega's zonder conflicten. Dit is een groot voordeel ten opzichte van binaire databasebestanden.
Automatisering met JSON
Bouw workflows die JSON als draaischijf gebruiken. Een formulier-inzending genereert een JSON-object, dat triggert een webhook, die stuurt de data naar Claude voor verwerking, en het resultaat wordt opgeslagen als een nieuw JSON-record. Alles automatisch, alles traceerbaar.
De volgende stap: Als je comfortabel bent met JSON, verken dan de mogelijkheden van MCP-servers. Met MCP maak je van je JSON-data een live databron die AI-assistenten direct kunnen raadplegen. Dat is de brug naar het gevorderde Builder-niveau.
Meer lezen en bronnen
Handige bronnen om verder te leren en te experimenteren met JSON.
De officiele specificatie van het JSON-formaat. Beknopt, duidelijk en beschikbaar in tientallen talen.
Online validator voor JSON-bestanden. Plak je JSON erin en zie direct of het geldig is en waar eventuele fouten zitten.
Gebruik Claude om JSON te genereren, valideren, transformeren en analyseren. Werkt naadloos met JSON-bestanden in je projecten.
De open standaard die volledig op JSON draait. Essentieel als je AI-tools wil koppelen aan externe databronnen.
Meer gidsen, masterclasses en praktische AI-toepassingen voor de grafische sector.
Niet elke oplossing
heeft een database nodig.Soms volstaat een bestand,
een heldere structuur,
en de moed om simpel te denken.
