Go Academy · 강의

JSON 응답 디코딩

API 응답을 Go 구조체로 파싱합니다.

JSON 응답 디코딩은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

디코딩하기 전에 상태 확인

항상 응답 상태가 2xx인지 확인한 후 본문 디코딩을 시도하십시오. 2xx가 아닌 응답에는 JSON이 아니라 HTML 오류 페이지가 포함될 수 있습니다.

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)

중첩 구조체

중첩된 Go 구조체와 json 태그를 사용하여 중첩된 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 오류를 구분하십시오. EOF는 본문이 비어 있어 JSON이 전혀 없다는 뜻입니다.

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

Content-Type 확인

HTML을 JSON으로 자동 처리하는 일을 방지하려면 디코딩하기 전에 응답 Content-Type이 application/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 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“JSON 응답 디코딩”에서 뭘 배우나요?

API 응답을 Go 구조체로 파싱합니다. 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Go Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“JSON 응답 디코딩” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Go Academy(으)로 돌아가기