0Pricing
Go Academy · Урок

Декодирование ответов JSON

Разбирайте ответы API в структуры Go

«Декодирование ответов JSON» — бесплатный урок Go Academy на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Go Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Go Academy содержит 4 уроков всего.

Проверяйте код состояния перед декодированием

Всегда проверяйте, что код состояния ответа относится к диапазону 2xx, прежде чем пытаться декодировать тело. Ответы с кодами, отличными от 2xx, могут содержать страницы с ошибками HTML, а не JSON.

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

json.NewDecoder

Декодируйте тело ответа потоково, не загружая его полностью в память:

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

Декодирование в универсальную карту

Для неизвестных или динамических структур JSON декодируйте данные в map[string]any:

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

Вложенные структуры

Представляйте вложенный JSON с помощью вложенных структур Go и тегов json:

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

Необязательные поля с указателями

Используйте типы-указатели для необязательных полей JSON, чтобы отличать «поле отсутствует» от «полю присвоено нулевое значение»:

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

Декодирование массивов

Декодируйте массивы JSON непосредственно в срезы Go:

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

Проверка ошибок декодирования

Различайте синтаксические ошибки JSON и ошибки неожиданного конца входных данных — EOF означает, что тело пусто и JSON полностью отсутствует.

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

Проверка Content-Type

Перед декодированием убедитесь, что Content-Type ответа равен application/json, чтобы случайно не разобрать HTML как JSON.

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

Игнорирование неизвестных полей

json.Decoder молча игнорирует поля JSON, которым не соответствует поле структуры. Это поведение используется по умолчанию и обычно желательно для совместимости с будущими версиями.

Строгое декодирование с DisallowUnknownFields

Вызовите dec.DisallowUnknownFields(), чтобы возвращать ошибку для неизвестных ключей — это полезно при строгом разборе конфигурации, но не при работе со сторонними API.

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

Повторное использование декодированной структуры

Перед декодированием обнуляйте структуру, если повторно используете её для нескольких ответов, чтобы избежать устаревших данных от предыдущего декодирования.

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

Быстрая проверка

Какую ошибку возвращает json.Decoder.Decode, если тело ответа пусто?

Итоги: декодирование ответов JSON

Основные положения:

  • Проверяйте код состояния перед декодированием
  • json.NewDecoder выполняет потоковое декодирование и не загружает всё тело в память
  • Проверяйте, что Content-Type равен application/json
  • io.EOF означает пустое тело; io.ErrUnexpectedEOF означает усечённый JSON

Часто задаваемые вопросы

Урок «Декодирование ответов JSON» бесплатный?

Да — полный текст урока «Декодирование ответов JSON» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Go Academy, подпишись на CoddyKit PRO. Курс Go Academy содержит 4 уроков всего.

Чему я научусь в уроке «Декодирование ответов JSON»?

Разбирайте ответы API в структуры Go Ты практикуешь Go Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Go Academy?

Предыдущий опыт не требуется. Go Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.

Сколько времени занимает урок «Декодирование ответов JSON»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Go Academy?

Да. Каждый урок Go Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Выполнение HTTP-запросов
  2. Настройка тайм-аутов и заголовков
  3. Декодирование ответов JSON
  4. Обработка ошибок и логика повторных попыток
← Назад к Go Academy