JSON-Formatter und Validator

So nutzen Sie den JSON-Formatter

Dieser JSON-Formatter macht JSON lesbar oder kompakt und zeigt genau, wo ein Syntaxfehler steckt. Fügen Sie Ihr JSON in den linken Bereich ein und wählen Sie Formatieren. Das Tool prüft zuerst, ob der Text gültiges JSON ist, und gliedert ihn dann übersichtlich, eingerückt mit zwei oder vier Leerzeichen oder einem Tabulator. Minifizieren bewirkt das Gegenteil: Es entfernt alle überflüssigen Leerzeichen und Zeilenumbrüche, sodass eine kompakte Fassung für eine Konfigurationsdatei, eine Testanfrage oder eine Umgebungsvariable übrig bleibt.

Aktivieren Sie Schlüssel alphabetisch sortieren, wenn Sie zwei API-Antworten vergleichen möchten. Objekte werden dann auf jeder Ebene nach Schlüsselnamen sortiert, während die Reihenfolge innerhalb von Arrays erhalten bleibt, weil sie in JSON sehr wohl eine Bedeutung hat. Unter dem Ergebnis sehen Sie, wie groß das JSON ist, wie viele Schlüssel es enthält und wie tief die Struktur verschachtelt ist. So prüfen Sie schnell, ob eine Antwort vollständig oder unerwartet groß ist.

Kopieren legt das Ergebnis in Ihre Zwischenablage, Herunterladen liefert eine .json-Datei. Alles geschieht in Ihrem Browser. Damit eignet sich das Tool auch für Daten, mit denen Sie sorgfältig umgehen möchten, etwa eine API-Antwort mit Kundendaten oder eine Konfiguration mit internen Adressen.

JSON validieren: Fehler mit Zeile und Spalte finden

Ein JSON-Validator sollte nicht nur melden, dass etwas falsch ist, sondern auch, wo. Lehnt eine API oder ein Import eine Datei ab, erhalten Sie oft nicht mehr als eine vage Meldung wie „Unexpected token“. Dieses Tool lokalisiert den Fehler selbst und zeigt Zeilennummer, Spalte und den umgebenden Text, wobei die Zeile im Eingabebereich hervorgehoben wird. Zum Fehler springen setzt Ihren Cursor direkt an die richtige Stelle.

Die meisten Fehler entstehen, weil JSON wie JavaScript aussieht, aber strenger ist. Schlüssel müssen immer in doppelten Anführungszeichen stehen, einfache Anführungszeichen sind nicht erlaubt, und nach dem letzten Element eines Objekts oder Arrays darf kein Komma folgen. Kommentare mit // oder /* */ gibt es in JSON ebenfalls nicht, ebenso wenig undefined, NaN oder die Python-Schreibweisen True und None. Erkennt das Tool ein solches Muster, ergänzt es einen konkreten Hinweis.

Ein Fehler steht nicht immer genau dort, wo er gemeldet wird. Fehlt ein Komma oder eine schließende Klammer, bemerkt der Parser das erst beim nächsten Zeichen. Sehen Sie sich deshalb auch die Zeile darüber an. Aus diesem Grund zeigt der Ausschnitt in der Fehlermeldung zwei Zeilen vor dem Fehler.

Was ist JSON und warum ist Formatierung wichtig?

JSON (JavaScript Object Notation) ist das Standardformat, mit dem Systeme Daten austauschen. Fast jede moderne API, vom Onlineshop und der Buchhaltungssoftware bis zum CRM oder Zahlungsanbieter, sendet und empfängt JSON. Das Format kennt nur wenige Bausteine: Objekte mit Schlüsseln und Werten, Arrays, Zeichenketten, Zahlen, true, false und null. Gerade weil es so einfach ist, kann jede Programmiersprache damit umgehen.

Für einen Computer macht die Formatierung keinen Unterschied: Minifiziertes und sauber eingerücktes JSON bedeuten genau dasselbe. Für Menschen ist der Unterschied enorm. Eine API-Antwort in einer einzigen langen Zeile ist unlesbar, während eine formatierte Fassung die Struktur auf einen Blick zeigt: welche Felder es gibt, was eine Liste enthält und wo ein Wert fehlt. Minifizieren nutzen Sie, wenn die Dateigröße zählt, etwa bei großen Datenmengen im Netzwerk oder begrenztem Speicherplatz.

Vorsicht bei sehr großen Zahlen. JSON selbst kennt keine Obergrenze, aber Browser und JavaScript rechnen nur mit Zahlen bis etwa 16 Stellen exakt. Eine ID oder Kontonummer mit mehr Stellen kann nach dem Formatieren daher leicht verändert zurückkommen. Systeme, die solche Werte austauschen, senden sie aus diesem Grund meist als Zeichenketten.

Von losem JSON zu einer zuverlässigen Schnittstelle

Ein Formatter ist ideal, um eine API-Antwort zu inspizieren oder eine Konfiguration zu prüfen. Kopieren Sie regelmäßig JSON aus einem System, bearbeiten es und fügen es in ein anderes ein, ist das ein Zeichen, dass eine richtige Schnittstelle Zeit und Fehler sparen würde. Eine gute Schnittstelle validiert die Daten automatisch gegen ein Schema, fängt Fehler ab, bevor sie in Ihre Daten gelangen, und protokolliert, was schiefgegangen ist.

Beim Entwurf einer solchen Schnittstelle geht es um mehr als nur das Format: welche Felder Pflicht sind, wie mit fehlenden Werten umgegangen wird, was passiert, wenn ein System vorübergehend nicht erreichbar ist, und wie verhindert wird, dass eine Bestellung doppelt verarbeitet wird. Genau an diesen Stellen geht manuelles Kopieren und Einfügen früher oder später schief.