CSV naar JSON

Maak van een spreadsheet JSON die klaar is voor API’s, importscripts of applicatiecode. De koptekstregel wordt de naam van de sleutels, getallen en booleans kunnen echte typen worden, en het resultaat kan leesbaar worden opgemaakt of compact voor verzending.

Hoe je een CSV omzet naar JSON

Sleep een CSV- of Excel-bestand erin. Van een werkmap wordt het eerste tabblad gebruikt.
Kies de structuur: array van objecten voor de meeste API’s, array van arrays voor ruwe data.
Kies of getallen en booleans worden getypeerd of alles tekst blijft.
Kies leesbaar of compact, voer uit en download het .json-bestand.

Wanneer je JSON nodig hebt

JSON is de taal waarin data over het web reist. Je hebt het nodig als je gegevens naar een API stuurt, een bestand klaarmaakt voor een importscript, een applicatie met voorbeelddata vult, of als een ontwikkelaar zegt: "stuur de data maar als JSON". Spreadsheets zijn prettig voor mensen, JSON is prettig voor programma’s.

Twee structuren

Een array van objecten gebruikt de koptekstregel als sleutelnamen:

[
  { "naam": "Sanne", "stad": "Utrecht", "actief": true },
  { "naam": "Joost", "stad": "Gent", "actief": false }
]

Dat verwacht bijna elke API, en elke regel is te lezen zonder naar de koptekst te kijken.

Een array van arrays bevat alleen de waarden. Het bestand is kleiner en past bij grote tabellen, maar je moet de kolomvolgorde zelf onthouden.

Typen omzetten

CSV kent geen typen: alles is tekst. Staat typen omzetten aan, dan wordt 42 een getal, worden true en false booleans en worden lege cellen null. Dat is meestal precies wat je code wil.

Zet typen omzetten uit als je deze kolommen hebt:

Postcodes en telefoonnummers die met een nul beginnen; als getal verliezen ze die nul.
Lange referentienummers, die precisie kunnen verliezen als ze als getal worden behandeld.
Codekolommen die uit cijfers bestaan maar eigenlijk labels zijn.

Leesbaar of compact

De leesbare opmaak zet inspringing en regeleindes erin, zodat een mens het kan lezen en controleren. De compacte opmaak haalt alle overbodige ruimte weg en levert een veel kleiner bestand, beter om over het netwerk te sturen of in een app te zetten. De inhoud is identiek.

Goede sleutelnamen

Je kolomnamen worden de sleutelnamen, dus maak ze eerst netjes in de spreadsheet: kleine letters, geen spaties, geen leestekens. "E-mailadres van de klant" schrijf je beter als email. Moet je eerst kolommen wegsnijden of herschikken, gebruik dan kolommen eruit halen.

Op je eigen apparaat

Data die naar een API gaat is meestal productiedata. Hier gebeuren het inlezen en het maken van de JSON in de browser, dus er gaat niets naar derden.

Veelgestelde vragen

Wat is het verschil tussen array van objecten en array van arrays?

Een array van objecten herhaalt de kolomnamen in elke regel, bijvoorbeeld {"naam":"Sanne","stad":"Utrecht"}. Bijna elke API verwacht dat. Een array van arrays bevat alleen de waarden: kleiner bestand, maar je moet de kolomvolgorde zelf onthouden.

Moet ik typen omzetten aanzetten?

Zet het aan als de JSON naar code of een database gaat die echte getallen verwacht. Zet het uit als je kolommen hebt als postcodes of telefoonnummers die hun voorloopnul zouden verliezen.

Wat gebeurt er met lege cellen?

Die worden lege tekst, of null als typen omzetten aanstaat. Volledig lege regels worden overgeslagen.

Wordt het bestand geüpload?

Nee. Het inlezen en het maken van de JSON gebeuren in je browser.

Je bestanden verlaten je apparaat nooit

Elke tool op Squishly Tools is 100% gratis en draait volledig in je browser. Je afbeeldingen en documenten worden op je eigen computer verwerkt en nooit naar een server geüpload. Geen accounts, geen watermerken en geen addertje onder het gras.