JSON naar CSV

Hoe het werkt

JSON is wat een API je geeft; CSV is wat een spreadsheet opent. Van het een naar het ander komen is een voortdurend klein klusje, dat meestal wordt gedaan door een payload in een willekeurige website te plakken — payloads die routinematig klantnamen, e-mailadressen en bestelgegevens bevatten. Dit converteert op de pagina, zodat de gegevens bij jou blijven.

Welke vorm het verwacht

Een array van objecten, wat een lijst-endpoint normaal teruggeeft. De kolomkoppen worden afgeleid uit de sleutels, verzameld over elk record, zodat rijen met ontbrekende velden toch goed uitgelijnd blijven. Een enkel object wordt behandeld als een tabel van één rij.

Aanhalingstekens worden goed afgehandeld

Waarden met komma's, aanhalingstekens of regeleinden worden tussen aanhalingstekens gezet en intern ge-escapet, volgens dezelfde conventie die spreadsheets verwachten. Dit is het onderdeel dat zelfgemaakte conversies bijna altijd verkeerd doen, en daarom verpest een adreskolom zo vaak een CSV.

Geneste waarden

Een waarde die zelf een object of een array is, wordt als JSON-tekst in de cel geschreven, omdat CSV plat is en nergens anders heen kan. Maak de structuur eerst plat als die velden ertoe doen.

Een scheidingsteken kiezen

Komma is de standaard. Puntkomma is wat Excel verwacht in landinstellingen waar de komma het decimaalteken is — als je spreadsheet het bestand opent met alles in één kolom samengeperst, is dat meestal de reden. Tab is het veiligst wanneer de gegevens zelf vol leestekens zitten.