Was ist JSON? Eine verständliche Anleitung mit Beispielen

JSON (JavaScript Object Notation) ist ein einfaches Textformat, um strukturierte Daten aufzuschreiben, etwa einen Kunden, eine Bestellung oder eine Liste von Produkten, und zwar als Namen mit zugehörigen Werten. Menschen können es leicht lesen, und Programme können es leicht erzeugen und auslesen. Wenn Apps und Dienste Daten über das Web austauschen, ist JSON mit Abstand das gebräuchlichste Format.

Warum JSON beim Bauen mit KI wichtig ist

JSON begegnet dir ständig, auch wenn du nie Code schreibst:

• APIs. Wenn die Bildschirme deiner App Daten aus dem Backend laden oder dein Backend einen Zahlungs-, E-Mail- oder KI-Dienst aufruft, reisen die Daten meist als JSON. Siehe was eine API ist.
• Einstellungsdateien. Viele Projektkonfigurationen sind JSON, zum Beispiel package.json, das die Abhängigkeiten eines JavaScript-Projekts auflistet.
• Datenbanken. Postgres kann JSON in einer Spalte speichern (den Typ jsonb), etwa für Daten, die nicht in saubere Zeilen und Spalten passen. Siehe was Postgres ist.
• KI-Ausgaben. Wenn ein KI-Modell etwas zurückgeben soll, das ein Programm verwenden kann, etwa eine Liste von Schlagwörtern oder extrahierte Rechnungsfelder, bittest du meist um JSON.
• Fehlermeldungen und Logs. Viele Fehler kommen als JSON an, und sie zu lesen ist oft der schnellste Weg herauszufinden, was schiefgelaufen ist.

JSON lesen zu können hilft dir zu prüfen, was deine App tatsächlich empfangen hat, ein fehlendes Feld zu erkennen und Probleme gegenüber deinem KI-App-Builder präzise zu beschreiben.

Ein Alltagsvergleich

Denk an ein Papierformular: Name: ____, Telefon: ____, Newsletter: ☐ ja ☐ nein. Jeder Eintrag ist eine Bezeichnung mit einem Wert daneben. JSON ist dieses Formular als Text, in einem strengen Layout, das ein Computer ohne Raten lesen kann. Und wie bei Formularen kann JSON Abschnitte in Abschnitten enthalten, etwa einen Adressblock mit Straße, Ort und PLZ, sowie Listen, etwa mehrere Telefonnummern.

Wie JSON aussieht

Hier ist eine einzelne Buchung in JSON:

{
  "id": 5001,
  "customer": "Lena Park",
  "service": "Haarschnitt",
  "startsAt": "2026-10-03T14:00:00Z",
  "price": 35.5,
  "paid": false,
  "notes": null,
  "extras": ["Bartpflege", "heißes Handtuch"],
  "contact": {
    "email": "lena@example.com",
    "phone": "+44 20 7946 0000"
  }
}

So liest du das:

• Geschweifte Klammern { } umschließen ein Objekt, also eine Menge von Name-Wert-Paaren.
• Jedes Paar hat die Form "name": Wert und wird durch Kommas getrennt.
• Eckige Klammern [ ] umschließen ein Array, also eine geordnete Liste.
• Objekte und Arrays können ineinander liegen, wie contact und extras es tun.

Die sechs Werttypen

JSON kennt nur sechs Arten von Werten. Diese kleine Liste ist ein großer Grund, warum es überall funktioniert.

Es gibt keinen Datumstyp. Daten werden als Zeichenketten geschrieben, meist im ISO-8601-Format wie oben (2026-10-03T14:00:00Z, wobei Z für UTC steht). Wenn man sich auf dieses Format einigt, vermeidet man eine ganze Klasse von Zeitzonenfehlern.

Die strengen Regeln (hier entstehen die Fehler)

JSON ist weniger nachsichtig, als es aussieht. Das alles ist ungültig:

{ name: "Lena" }            ← Schlüssel ohne doppelte Anführungszeichen
{ 'name': 'Lena' }          ← einfache Anführungszeichen
{ "a": 1, "b": 2, }         ← nachgestelltes Komma
{ "a": 1 "b": 2 }           ← fehlendes Komma
{ "a": 1 // Kommentar }     ← Kommentare sind nicht erlaubt

Die meisten Fehlermeldungen wie „Unexpected token“ gehen auf eine dieser Ursachen zurück. Ein JSON-Validator oder -Formatierer zeigt dir die genaue Zeile.

Ein Beispiel: JSON durch eine App

Eine Kundin bucht in einer Salon-App einen Haarschnitt. Hier taucht JSON auf:

1. Das Buchungsformular schickt dies an das Backend der App:

{ "service": "Haarschnitt", "startsAt": "2026-10-03T14:00:00Z", "name": "Lena Park" }

1. Das Backend speichert die Buchung in der Datenbank und antwortet mit dem Status 201 Created und:

{ "id": 5001, "status": "confirmed" }

1. Ist der Termin bereits vergeben, antwortet es vielleicht stattdessen mit dem Status 409 Conflict und:

{ "error": "slot_taken", "message": "Dieser Termin wurde gerade gebucht. Bitte wähle einen anderen." }

Die Seite liest status oder error und zeigt die passende Meldung an. Zeigt die Seite stattdessen einen leeren Bildschirm, würde der Blick in die Entwicklerwerkzeuge des Browsers (Tab Netzwerk) genau dieses JSON zeigen. Das ist oft der schnellste Hinweis darauf, was schiefgelaufen ist.

Wichtige Begriffe

Häufige Missverständnisse

• „JSON ist JavaScript.“ Es stammt aus der Syntax von JavaScript, ist aber sprachunabhängig. Python, Java, C#, Go und alle anderen lesen es.
• „Zahlen in Anführungszeichen sind in Ordnung.“ "35" ist eine Zeichenkette, keine Zahl. Das Mischen führt zu Fehlern, etwa wird "35" + "5" zu "355". Geld speichert man oft als ganze Cent (3550), um Rundungsprobleme zu vermeiden.
• „JSON ist sicher, weil es nur Daten sind.“ JSON kann alles transportieren, auch Geheimnisse. Lege keine API-Schlüssel in JSON, das an den Browser gesendet wird.
• „Alles in eine JSON-Spalte packen.“ Praktisch für flexible Extras, aber Daten, nach denen du suchst, filterst oder die du verknüpfst, gehören meist in richtige Spalten.
• „Die KI liefert immer gültiges JSON.“ Modelle können zusätzlichen Text hinzufügen oder das Format brechen. Viele Anbieter bieten einen Modus mit strukturierter Ausgabe an, dein Code sollte das Ergebnis trotzdem prüfen.

Was du deinen KI-App-Builder fragen solltest

• „Zeig mir ein Beispiel für das JSON, das dieser Endpunkt zurückgibt.“
• „Gib Fehler als JSON mit einem error-Code und einer lesbaren message zurück.“
• „Speichere Datumsangaben als ISO-8601-Zeichenketten in UTC und wandle sie erst auf dem Bildschirm in die lokale Zeit um.“
• „Speichere Preise als ganzzahlige Cent.“
• „Prüfe eingehendes JSON auf dem Server und lehne Anfragen mit fehlenden oder falsch typisierten Feldern ab.“
• „Wenn du das KI-Modell aufrufst, fordere JSON in genau dieser Form an und prüfe es, bevor du es verwendest.“

JSON in Mythex

In Mythex musst du JSON nicht von Hand schreiben. Du beschreibst, was du willst, und der Agent schreibt den Code, der die Daten sendet und liest. Trotzdem hilft es, JSON zu erkennen. Wenn etwas kaputtgeht, gibt die Einfügung der JSON-Fehlermeldung in den Chat dem Agenten einen präzisen Hinweis. Das REST-API-Backend-Rezept der Dokumentation verlangt von Anfang an „klare JSON-Fehler“, und das Rezept beliebige API anbinden beschreibt den Aufruf externer Dienste. Für das größere Bild siehe REST vs. GraphQL und wie du eine mit KI gebaute App debuggst.

Fragen