JSON-API-Antworten lesen und debuggen
Wenn eine Integration nicht funktioniert, steht die Antwort meist im Body der Antwort. Dieser Leitfaden zeigt, wie du eine Antwort erfasst, lesbar machst und die Felder findest, die erklären, was schiefgelaufen ist.
Tool öffnen: JSON-Formatierer für API-Antworten
1. Die vollständige Antwort erfassen
Nutze den Netzwerk-Tab der Entwicklertools für Anfragen einer Webseite und curl für alles andere. curl -i zeigt neben dem Body auch Statuscode und Header, die einen Fehler oft schon erklären, bevor du das JSON liest.
Kopiere die ganze Antwort. Eine abgeschnittene Antwort aus einem Log oder Terminal lässt sich nicht formatieren, weil die schließenden Klammern fehlen.
2. Zuerst den Statuscode prüfen
| Status | Bedeutung | Im Body suchen nach |
|---|---|---|
| 200, 201 | Erfolg | Den angefragten oder erstellten Daten |
| 400, 422 | Ungültige Anfrage | Einer Liste von Feldern und Validierungsmeldungen |
| 401, 403 | Fehlende oder unzureichende Berechtigung | Hinweisen zu Token oder Scope |
| 404 | Nicht gefunden | Ob Pfad oder ID falsch sind |
| 429 | Zu viele Anfragen | Wartezeit oder Angaben zum Rate Limit |
| 500 bis 504 | Server- oder Gateway-Fehler | Einer Request-ID für den API-Anbieter |
3. Lesbar machen
Füge die Antwort in den JSON-Formatierer ein. Beginnt sie mit Headern oder einem JSONP-Callback, werden diese entfernt. Siehst du viele \", wurde das JSON doppelt kodiert, und der Formatierer dekodiert es.
Wechsle zur Baumansicht und klappe große Arrays zu. Die meisten APIs packen Ergebnisse in ein Feld wie data, items oder results, Angaben zur Paginierung stehen in meta, links oder next.
4. Der Paginierung folgen
Listen werden meist auf Seiten aufgeteilt. Suche nach Feldern wie next, next_cursor, page und total. Fordere die nächste Seite mit dem Cursor oder der URL an, die die API liefert, statt sie selbst zu bauen, denn Cursor können sich zwischen Aufrufen ändern.
5. Vorsicht bei Zahlen und Datumswerten
IDs mit mehr als 15 oder 16 Ziffern können in JavaScript gerundet werden. Nutze die Textversion der ID, wenn die API eine anbietet. Datumswerte sind meist ISO-8601-Texte wie 2026-01-15T09:30:00Z, wobei Z für UTC steht. Rechne sie erst bei der Anzeige in Ortszeit um.