Go Academy · Lekcja

Dekodowanie odpowiedzi JSON

Parsowanie odpowiedzi API do struktur Go

Dekodowanie odpowiedzi JSON to bezpłatna lekcja Go Academy na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Go Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Go Academy zawiera 4 lekcji w sumie.

Sprawdzanie statusu przed dekodowaniem

Przed próbą zdekodowania treści zawsze sprawdzaj, czy status odpowiedzi należy do zakresu 2xx. Odpowiedzi inne niż 2xx mogą zawierać strony błędów HTML zamiast JSON.

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

json.NewDecoder

Dekoduj treść odpowiedzi strumieniowo, bez wczytywania jej w całości do pamięci:

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

Dekodowanie do ogólnej mapy

W przypadku nieznanych lub dynamicznych struktur JSON dekoduj dane do map[string]any:

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

Zagnieżdżone struktury

Odwzoruj zagnieżdżony JSON za pomocą zagnieżdżonych struktur Go i tagów json:

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

Opcjonalne pola ze wskaźnikami

Używaj typów wskaźnikowych dla opcjonalnych pól JSON, aby rozróżnić sytuacje, w których „pola nie ma”, od tych, w których „pole ma wartość zero”:

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

Dekodowanie tablic

Dekoduj tablice JSON bezpośrednio do wycinków Go:

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

Sprawdzanie błędów dekodowania

Rozróżniaj błędy składni JSON od błędów unexpected EOF — EOF oznacza, że treść jest pusta (nie zawiera żadnego JSON-a).

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

Sprawdzanie Content-Type

Przed dekodowaniem sprawdź, czy nagłówek Content-Type odpowiedzi ma wartość application/json, aby uniknąć cichego parsowania HTML jako JSON.

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

Ignorowanie nieznanych pól

json.Decoder po cichu ignoruje pola JSON, które nie mają odpowiadającego im pola w strukturze. Jest to zachowanie domyślne i zwykle pożądane ze względu na zgodność wsteczną z przyszłymi wersjami.

Ścisłe dekodowanie za pomocą DisallowUnknownFields

Wywołaj dec.DisallowUnknownFields(), aby zwracać błąd w przypadku nieznanych kluczy — jest to przydatne przy ścisłym parsowaniu konfiguracji, ale nie przy korzystaniu z interfejsów API dostawców zewnętrznych.

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

Ponowne używanie zdekodowanej struktury

Przed dekodowaniem wyzeruj strukturę, jeśli używasz jej ponownie dla wielu odpowiedzi, aby uniknąć pozostawienia nieaktualnych danych z poprzedniego dekodowania.

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

Szybkie sprawdzenie

Jaki błąd zwraca json.Decoder.Decode, gdy treść odpowiedzi jest pusta?

Podsumowanie: dekodowanie odpowiedzi JSON

Najważniejsze informacje:

Przed dekodowaniem sprawdzaj kod statusu
json.NewDecoder służy do dekodowania strumieniowego i pozwala uniknąć przechowywania całej treści w pamięci
Sprawdzaj, czy Content-Type ma wartość application/json
io.EOF oznacza pustą treść; io.ErrUnexpectedEOF oznacza obcięty JSON

Często zadawane pytania

Czy lekcja „Dekodowanie odpowiedzi JSON” jest bezpłatna?

Tak — pełny tekst „Dekodowanie odpowiedzi JSON” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Go Academy, przejdź na CoddyKit PRO. Kurs Go Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Dekodowanie odpowiedzi JSON”?

Parsowanie odpowiedzi API do struktur Go Ćwiczysz Go Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Go Academy?

Nie wymagamy żadnego doświadczenia. Go Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.

Ile czasu zajmuje lekcja „Dekodowanie odpowiedzi JSON”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Go Academy?

Tak. Każda lekcja Go Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do Go Academy