Was ist JSON?

JSON steht für JavaScript Object Notation und ist ein einfaches Textformat für den Austausch von strukturierten Daten zwischen Systemen. Es hat sich als das Standard-Datenformat für REST-APIs durchgesetzt und ist heute das am weitesten verbreitete Format für Maschine-zu-Maschine-Kommunikation.

Der Name leitet sich von JavaScript ab, in dem das Format ursprünglich entstand. JSON ist aber sprachunabhängig und wird in Python, PHP, Java, Go, Ruby und praktisch jeder anderen Programmiersprache nativ unterstützt.

Wie sieht JSON aus?

JSON besteht aus Schlüssel-Wert-Paaren in geschweiften Klammern. Ein einfaches Beispiel für eine Bestellung:

{
  "orderId": "ORD-12345",
  "customer": {
    "name": "Max Muster",
    "email": "max@example.com"
  },
  "items": [
    {
      "productId": "PROD-001",
      "quantity": 2,
      "price": 29.99
    }
  ],
  "totalAmount": 59.98,
  "paid": true
}

JSON kennt sechs Datentypen: String (Text in Anführungszeichen), Number (Ganzzahl oder Dezimalzahl), Boolean (true oder false), null (kein Wert), Object (verschachtelte Schlüssel-Wert-Paare in {}) und Array (Liste in []).

JSON vs. XML

Vor JSON war XML das vorherrschende Datenformat für APIs. XML ist ausführlicher und hat mehr Markup-Overhead. Dasselbe Beispiel in XML wäre erheblich länger. Für Menschen ist JSON leichter zu lesen. Für Maschinen ist JSON schneller zu parsen. Die meisten modernen APIs setzen deshalb auf JSON.

Es gibt immer noch Systeme, die XML verwenden, besonders ältere ERP-Systeme und Schnittstellen wie SOAP-WebServices. In diesen Fällen muss eine Automation zwischen JSON und XML hin- und herkonvertieren können.

Validierung und JSON Schema

Wenn eine API JSON empfängt, sollte sie die Struktur validieren, bevor sie die Daten verarbeitet. JSON Schema ist ein Standard, der die erwartete Struktur einer JSON-Datei beschreibt: Welche Felder sind Pflicht? Welche Datentypen werden erwartet? Was sind gültige Wertebereiche?

Ein Beispiel: Das Feld quantity sollte eine positive Ganzzahl sein. Wenn die API eine negative Zahl oder einen String empfängt, soll sie mit einer klaren Fehlermeldung antworten, statt die fehlerhafte Zahl einfach in die Datenbank zu schreiben.

JSON ist das Fundament moderner Systemkommunikation. Bei der Automation und Softwareentwicklung arbeiten wir täglich damit. Beim Termin können wir auch technisch wenig versierten Kunden zeigen, wie ihre Systeme miteinander sprechen, und was das für ihre Prozesse bedeutet.