Go Academy · Lektion

JSON-Antworten dekodieren

API-Antworten in Go-Structs parsen

JSON-Antworten dekodieren ist eine kostenlose Go Academy-Lektion auf CoddyKit. Dies ist Lektion 3 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Go Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Go Academy-Kurs umfasst insgesamt 4 Lektionen.

Status vor dem Dekodieren prüfen

Überprüfen Sie immer, ob der Response-Status 2xx ist, bevor Sie versuchen, den Body zu dekodieren. Responses mit einem anderen Status als 2xx können HTML-Fehlerseiten statt JSON enthalten.

if resp.StatusCode < 200 || resp.StatusCode >= 300 {
    body, _ := io.ReadAll(resp.Body)
    return fmt.Errorf("status %d: %s", resp.StatusCode, body)
}

json.NewDecoder

Dekodieren Sie den Response-Body als Stream, ohne ihn vollständig in den Speicher zu laden:

var result APIResponse
if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
    return fmt.Errorf("decode: %w", err)
}

In eine generische Map dekodieren

Bei unbekannten oder dynamischen JSON-Strukturen dekodieren Sie in map[string]any:

var m map[string]any
json.NewDecoder(resp.Body).Decode(&m)

Verschachtelte Structs

Modellieren Sie verschachteltes JSON mit verschachtelten Go-Structs und json-Tags:

type Repo struct {
    Name  string `json:"name"`
    Owner struct {
        Login string `json:"login"`
    } `json:"owner"`
}

Optionale Felder mit Zeigern

Verwenden Sie Zeigertypen für optionale JSON-Felder, damit Sie zwischen „Feld fehlt“ und „Feld auf den Nullwert gesetzt“ unterscheiden können:

type Response struct {
    Data  *string `json:"data"`
    Error *string `json:"error"`
}

Arrays dekodieren

Dekodieren Sie JSON-Arrays direkt in Go-Slices:

var users []User
json.NewDecoder(resp.Body).Decode(&users)

Dekodierungsfehler prüfen

Unterscheiden Sie zwischen JSON-Syntaxfehlern und Fehlern durch ein unerwartetes Dateiende – EOF bedeutet, dass der Body leer ist (also überhaupt kein JSON enthält).

err := json.NewDecoder(resp.Body).Decode(&v)
if errors.Is(err, io.EOF) {
    return fmt.Errorf("empty response body")
}

Content-Type prüfen

Überprüfen Sie vor dem Dekodieren, ob der Response-Content-Type application/json ist, damit nicht versehentlich HTML als JSON geparst wird.

ct := resp.Header.Get("Content-Type")
if !strings.HasPrefix(ct, "application/json") {
    return fmt.Errorf("unexpected content-type: %s", ct)
}

Unbekannte Felder ignorieren

json.Decoder ignoriert JSON-Felder ohne passendes Struct-Feld stillschweigend. Das ist die Standardeinstellung und für die Abwärtskompatibilität in der Regel wünschenswert.

Striktes Dekodieren mit DisallowUnknownFields

Rufen Sie dec.DisallowUnknownFields() auf, damit unbekannte Schlüssel einen Fehler verursachen – nützlich beim strikten Parsen von Konfigurationen, aber nicht beim Verarbeiten von APIs Dritter.

dec := json.NewDecoder(r.Body)
dec.DisallowUnknownFields()
dec.Decode(&cfg)

Die dekodierte Struct wiederverwenden

Setzen Sie die Struct vor dem Dekodieren auf den Nullwert zurück, wenn Sie sie für mehrere Responses wiederverwenden, damit keine veralteten Daten aus einem vorherigen Dekodiervorgang erhalten bleiben.

var result APIResult
result = APIResult{} // reset
json.NewDecoder(resp.Body).Decode(&result)

Kurzer Test

Welche Fehlermeldung gibt json.Decoder.Decode zurück, wenn der Response-Body leer ist?

Zusammenfassung: JSON-Responses dekodieren

Wichtige Punkte:

Prüfen Sie den Statuscode vor dem Dekodieren
json.NewDecoder für Streaming; verhindert, dass der gesamte Body im Speicher liegt
Überprüfen Sie, ob der Content-Type application/json ist
io.EOF bedeutet einen leeren Body; io.ErrUnexpectedEOF bedeutet abgeschnittenes JSON

Häufig gestellte Fragen

Ist die Lektion „JSON-Antworten dekodieren“ kostenlos?

Ja — der vollständige Text von „JSON-Antworten dekodieren“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Go Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Go Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „JSON-Antworten dekodieren“?

API-Antworten in Go-Structs parsen Du übst Go Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um Go Academy zu starten?

Keine Vorkenntnisse erforderlich. Go Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 3 von 4.

Wie lange dauert die Lektion „JSON-Antworten dekodieren“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser Go Academy-Lektion Code schreiben und ausführen?

Ja. Jede Go Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

← Zurück zu Go Academy