Wer mit REST-APIs arbeitet, begegnet früher oder später einem Begriff: JSON. Nahezu jede moderne API antwortet in diesem Format – egal ob du Wetterdaten abrufst, Zahlungen verarbeitest oder Daten aus deiner eigenen instantapi.io-API liest. Doch was genau ist JSON, wie liest man es, und warum hat es andere Formate wie XML fast vollständig verdrängt?
In diesem Artikel erklären wir dir JSON von Grund auf – mit echten Beispielen, einem Blick auf die Syntax und einem direkten Vergleich zu XML und CSV.
Was ist JSON?
JSON steht für JavaScript Object Notation. Es handelt sich um ein schlankes, textbasiertes Datenformat zum Austausch strukturierter Daten zwischen Systemen. Obwohl der Name „JavaScript" enthält, ist JSON sprachunabhängig – es wird in Python, PHP, Java, Go, Ruby und praktisch jeder anderen Programmiersprache unterstützt.
JSON wurde Anfang der 2000er Jahre von Douglas Crockford formalisiert und hat sich seitdem als das Standardformat für Web-APIs durchgesetzt. Es ist für Menschen lesbar und gleichzeitig von Maschinen effizient parsebar – eine seltene Kombination.
JSON ist wie ein strukturiertes Notizbuch: Es speichert benannte Werte in einer Form, die sowohl ein Mensch als auch ein Computer auf Anhieb versteht.
Die JSON-Syntax im Detail
JSON kennt genau zwei Strukturtypen: Objekte und Arrays. Alles andere sind Werte innerhalb dieser Strukturen.
Objekte – benannte Daten
Ein JSON-Objekt ist eine Sammlung von Schlüssel-Wert-Paaren, eingeschlossen in geschweifte Klammern {}. Jeder Schlüssel ist ein String in Anführungszeichen, gefolgt von einem Doppelpunkt und dem zugehörigen Wert.
Arrays – geordnete Listen
Ein JSON-Array ist eine geordnete Liste von Werten, eingeschlossen in eckige Klammern []. Die Werte können beliebige JSON-Typen sein – auch wieder Objekte oder Arrays.
Die sechs JSON-Datentypen
JSON unterstützt exakt sechs Datentypen. Nichts mehr, nichts weniger – und das ist eine seiner größten Stärken: maximale Einfachheit.
| Typ | Beispiel | Beschreibung |
|---|---|---|
| String | "Hallo Welt" | Text, immer in doppelten Anführungszeichen |
| Number | 42, 3.14 | Ganz- oder Dezimalzahlen, kein spezieller Integer-Typ |
| Boolean | true, false | Wahrheitswerte, immer kleingeschrieben |
| null | null | Kein Wert / leeres Feld, immer kleingeschrieben |
| Object | { "key": "val" } | Benannte Schlüssel-Wert-Sammlung |
| Array | [1, 2, 3] | Geordnete Liste beliebiger Werte |
In JSON müssen Schlüssel immer in doppelten Anführungszeichen stehen. Einfache Anführungszeichen oder Schlüssel ohne Quotes führen zu einem Parse-Fehler. { name: "Maria" } ist kein gültiges JSON – { "name": "Maria" } schon.
Verschachteltes JSON – die Realität
In der Praxis sind JSON-Strukturen selten flach. Objekte können andere Objekte und Arrays enthalten, die wiederum Objekte enthalten – das nennt man Verschachtelung. Hier ein realistisches Beispiel, wie instantapi.io eine API-Antwort zurückgibt:
Du siehst alle sechs Datentypen im Einsatz: String, Number, Boolean, null, Object und Array. Das Schlüsselwort "notizen": null signalisiert dabei, dass das Feld existiert, aber keinen Wert hat – anders als wenn es gar nicht vorhanden wäre.
JSON vs. XML – warum JSON gewonnen hat
Vor JSON war XML (Extensible Markup Language) das dominante Format für den Datenaustausch. Noch heute findet man XML in Unternehmensintegrationen und SOAP-APIs. Der Vergleich ist aufschlussreich:
Dieselben Daten – zwei Formate
JSON: { "name": "Maria", "alter": 34 }
XML: <person><name>Maria</name><alter>34</alter></person>
Beide transportieren dieselbe Information – aber JSON benötigt deutlich weniger Zeichen und ist ohne Einarbeitung lesbar.
| Kriterium | JSON | XML | CSV |
|---|---|---|---|
| Lesbarkeit | Sehr gut | Mittel | Gut (flache Daten) |
| Dateigröße | Kompakt | Groß (Tags verdoppeln Daten) | Sehr kompakt |
| Verschachtelung | Nativ unterstützt | Nativ unterstützt | Nicht möglich |
| Typisierung | 6 Basistypen | Nur Text (Schemas nötig) | Nur Text |
| API-Nutzung | Industriestandard | Legacy / SOAP | Export, nicht APIs |
| Parser-Aufwand | Niedrig | Hoch | Niedrig |
CSV ist ideal für tabellarische Daten ohne Hierarchie – und genau dort setzt instantapi.io an: Du lädst eine CSV- oder Excel-Datei hoch, und die Plattform verwandelt sie automatisch in eine JSON-basierte REST-API. Was vorher nur in einer Tabellenkalkulation zugänglich war, ist ab sofort für jede Anwendung abrufbar.
Warum verwenden APIs JSON?
Die Dominanz von JSON in APIs ist kein Zufall. Mehrere Faktoren haben sie begünstigt:
- JavaScript-native: Da Webbrowser JavaScript ausführen, lässt sich JSON ohne zusätzliche Bibliothek direkt parsen –
JSON.parse()ist in jedem Browser eingebaut. - Universelle Sprachunterstützung: Python hat
json.loads(), PHPjson_decode(), Java hat Jackson und Gson. Kein Ökosystem ist außen vor. - Menschenlesbar: Entwickler können API-Antworten im Browser, im Terminal oder in Postman direkt lesen und debuggen.
- Schlankes Format: JSON überträgt weniger Bytes als äquivalentes XML – relevant bei mobilen Verbindungen und hohem API-Traffic.
- Flexibel erweiterbar: Neue Felder können zur API-Antwort hinzugefügt werden, ohne bestehende Clients zu brechen.
JSON lesen und schreiben – praktische Tipps
JSON formatieren
Komprimiertes JSON spart Bytes, ist aber schlecht lesbar: {"name":"Maria","alter":34}. Tools wie jsonformatter.org oder der eingebaute Pretty-Print in Postman und Chrome DevTools helfen, JSON übersichtlich darzustellen.
JSON validieren
Ein einziges fehlendes Komma oder eine ungeschlossene Klammer macht das gesamte JSON-Dokument ungültig. Online-Validatoren wie jsonlint.com oder die Fehlermeldungen moderner Browser-DevTools zeigen dir genau, wo das Problem liegt.
JSON in instantapi.io
Jede API-Antwort von instantapi.io folgt einer konsistenten JSON-Struktur. Eine Listenabfrage liefert immer:
Das Feld total gibt die Gesamtzahl der Datensätze an, page und limit ermöglichen Pagination. So können Client-Anwendungen große Datensätze seitenweise laden, ohne den Server zu überlasten.
Nutze in deinem Browser die URL deiner instantapi.io-API direkt – Chrome und Firefox stellen JSON automatisch formatiert dar, wenn du die Erweiterung „JSON Viewer" installierst. So kannst du deine Daten ohne Code schnell prüfen.
Fazit: JSON ist die Sprache der APIs
JSON ist einfach, universell und mächtig genug für nahezu jeden Anwendungsfall. Seine sechs Datentypen, die natürliche Lesbarkeit und die breite Unterstützung in allen Programmiersprachen machen es zum unangefochtenen Standard für REST-APIs.
Wenn du mit instantapi.io arbeitest, begegnest du JSON bei jeder API-Anfrage. Das Gute: Du musst kein Entwickler sein, um es zu verstehen. Mit etwas Übung liest du eine JSON-Antwort genauso schnell wie eine E-Mail.
Deine Daten als JSON-API – in 5 Minuten
Lade eine Excel- oder CSV-Datei hoch und instantapi.io liefert dir sofort eine vollwertige JSON-REST-API – mit Filterung, Suche und Pagination.
Kostenlos ausprobieren →