API-Antworten lesen ohne den Verstand zu verlieren

Du rufst einen API-Endpunkt auf. Die Antwort kommt zurück. Sie sieht so aus:

{"users":[{"id":1,"name":"John","email":"john@example.com","settings":{"notifications":true,"theme":"dark","language":"en"}},{"id":2,"name":"Jane","email":"jane@example.com","settings":{"notifications":false,"theme":"light","language":"es"}}],"meta":{"total":2,"page":1}}

Viel Glück beim Finden des einen Feldes, das du brauchst.

So sehen 90% des API-Debuggings aus. Minifiziertes JSON, keine Zeilenumbrüche, alles zusammengequetscht. Es ist technisch korrekt. Es ist auch unleserlich.

Formatiere es einfach

Nimm diese Textwand, füge sie in einen JSON-Formatierer ein, und plötzlich:

{
  "users": [
    {
      "id": 1,
      "name": "John",
      "email": "john@example.com",
      "settings": {
        "notifications": true,
        "theme": "dark",
        "language": "en"
      }
    }
  ]
}

Dieselben Daten. Tatsächlich lesbar. Du kannst die Struktur sehen, verschachtelte Felder finden, fehlende Werte erkennen.

Häufige Debugging-Szenarien

„Die API gibt einen Fehler zurück, aber ich weiß nicht warum"

Formatiere die Fehler-Antwort. Oft gibt es ein verschachteltes message- oder details-Feld darin vergraben, das genau erklärt, was schiefgelaufen ist. Du konntest es nur in der minifizierten Version nicht sehen.

„Ich muss zwei Antworten vergleichen"

Formatiere beide, dann verwende ein Diff-Tool. Minifiziertes JSON ist unmöglich zu diffen – alles zeigt sich als geändert, weil Zeilenumbrüche unterschiedlich sind.

„Ist das überhaupt valides JSON?"

Füge es in einen Formatierer ein. Wenn es ungültig ist, bekommst du einen Fehler, der auf das Problem zeigt. Fehlendes Komma, zusätzliche Klammer, nicht maskiertes Anführungszeichen – der Formatierer wird es dir sagen.

Mit JWTs arbeiten

JWTs (JSON Web Tokens) sind nur Base64-kodiertes JSON. Wenn du so etwas siehst:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ

Das ist nicht verschlüsselt. Es ist nur kodiert. Dekodiere es und du siehst den tatsächlichen Payload – Nutzer-ID, Ablaufzeit, Berechtigungen, was auch immer das Token enthält.

Nützlich zum Debuggen von Auth-Problemen. „Warum bekomme ich 403?" Dekodiere das Token, prüfe, ob es abgelaufen ist, verifiziere, dass die Claims dem entsprechen, was du erwartest.

Base64 in API-Antworten

Manchmal geben APIs Base64-kodierte Daten zurück. Dateiinhalte, Bilder, verschlüsselte Blobs. Wenn du sehen musst, was tatsächlich drin ist, dekodiere es.

Häufig in:

• E-Mail-APIs (Anhänge kommen Base64-kodiert)
• Bild-Uploads (Data-URIs sind Base64)
• Legacy-SOAP-Services (weil SOAP)

Tipps für API-Arbeit

Verwende Browser-Dev-Tools. Der Netzwerk-Tab zeigt Anfragen und Antworten. Die meisten Browser können JSON-Antworten automatisch schön formatieren.

Speichere Beispiel-Antworten. Wenn eine API korrekt funktioniert, speichere eine formatierte Kopie. Wenn sie kaputt geht, kannst du gegen die funktionierende Version vergleichen.

Prüfe den Content-Type. Manchmal ist das, was wie JSON aussieht, tatsächlich ein String, der JSON enthält. Du musst es möglicherweise zweimal parsen.

Achte auf Kodierungsprobleme. Unicode-Zeichen können Probleme verursachen. Wenn du \u0000-Codes siehst, ist das maskiertes Unicode – normalerweise ok, aber manchmal deutet es auf Kodierungsprobleme upstream hin.

---

API-Debugging dreht sich hauptsächlich darum, die Daten klar zu sehen. Formatiere dein JSON, dekodiere deine Tokens, und du verbringst weniger Zeit damit, auf minifizierte Blobs zu starren.