JSON (JavaScript Object Notation) ist das meistgenutzte Datenformat im Web. Praktisch jede API, jede Konfigurationsdatei moderner Tools und jeder Datenaustausch zwischen Frontend und Backend läuft heute über JSON. Das Format ist bewusst simpel gehalten – gerade deshalb stolpern viele über kleine, aber folgenreiche Syntaxfehler.
Wofür JSON gut ist
JSON wurde entwickelt, um strukturierte Daten in einer Form zu speichern, die sowohl für Menschen lesbar als auch für Maschinen leicht verarbeitbar ist. Es ist textbasiert, sprachunabhängig und kompakt. Obwohl der Name auf JavaScript verweist, kann heute jede gängige Programmiersprache JSON lesen und schreiben.
Der Aufbau in zwei Strukturen
JSON kennt nur zwei zusammengesetzte Strukturen, die sich beliebig verschachteln lassen:
- Objekte stehen in geschweiften Klammern
{ }und enthalten Schlüssel-Wert-Paare. Der Schlüssel ist immer ein in doppelte Anführungszeichen gesetzter Text, gefolgt von einem Doppelpunkt und dem Wert. - Arrays stehen in eckigen Klammern
[ ]und enthalten eine geordnete Liste von Werten, getrennt durch Kommas.
Als Werte sind erlaubt: Texte (immer in doppelten Anführungszeichen), Zahlen, die Wahrheitswerte true und false, der Leerwert null sowie wiederum Objekte und Arrays. Ob deine Struktur diesen Regeln folgt, prüfst du am schnellsten mit dem JSON Validator, der die Eingabe einliest und bei einem Fehler genau anzeigt, wo es klemmt.
Die häufigsten Syntaxfehler
JSON ist streng. Schon kleine Abweichungen führen dazu, dass eine API die Anfrage komplett ablehnt. Diese Fehler treten am häufigsten auf:
- Trailing Comma: Ein Komma nach dem letzten Element eines Objekts oder Arrays ist in JSON verboten – anders als in JavaScript.
- Einfache Anführungszeichen: JSON erlaubt nur doppelte Anführungszeichen.
'name'ist ungültig,"name"korrekt. - Schlüssel ohne Anführungszeichen: Jeder Schlüssel muss in doppelte Anführungszeichen gesetzt werden, auch wenn er wie ein einfaches Wort aussieht.
- Fehlende oder zu viele Kommas: Zwischen zwei Elementen muss genau ein Komma stehen, nach dem letzten keines.
- Kommentare: JSON unterstützt keine Kommentare. Zeilen mit
//oder/* */machen die Datei ungültig.
Warum Formatieren hilft
Wenn JSON von einer API kommt, ist es oft in eine einzige lange Zeile gepresst (minifiziert), um Bandbreite zu sparen. Für Maschinen ist das ideal, für Menschen unlesbar. Beim Formatieren (auch "Pretty Printing" genannt) wird die Struktur mit Einrückungen und Zeilenumbrüchen aufbereitet, sodass die Verschachtelung sofort sichtbar wird. Das macht Fehlersuche und Verständnis enorm einfacher.
Der JSON Validator übernimmt beides in einem Schritt: Er prüft die Gültigkeit und gibt das Ergebnis sauber eingerückt aus. Du fügst rohes JSON ein und erhältst eine lesbare, korrekt strukturierte Version zurück.
JSON im Alltag der Entwicklung
Beim Arbeiten mit JSON kommen schnell weitere Aufgaben dazu. Wenn du JSON-Daten in eine Tabelle überführen willst, hilft der JSON zu CSV Konverter. Geht es darum, Daten sicher in einem URL- oder Header-Kontext zu übertragen, ist der Base64 Encoder Decoder oft die passende Ergänzung. Eine Übersicht aller Entwickler-Werkzeuge findest du unter kotsch.tech/webtools.
Fazit
JSON ist einfach aufgebaut, aber unnachgiebig bei der Syntax. Die meisten Probleme entstehen durch Trailing Commas, falsche Anführungszeichen oder Kommentare. Wer sein JSON vor dem Versenden prüft und formatiert, spart sich kryptische API-Fehler. Der JSON Validator erledigt Validierung und Formatierung lokal im Browser in einem Durchgang.