JSON을 Go struct로 변환하세요!

JSON을 입력하면 json 태그가 붙은 Go(Golang) struct로 변환합니다!
JSON
결과

JSON을 Go struct로 변환하세요!

JSON을 encoding/json 태그가 달린 Go struct 정의로 변환합니다. 필드 이름은 Go의 exported 규칙과 golint 약어 규칙(ID, URL, API 등)에 맞춰 만들고, 출력은 gofmt를 돌린 것처럼 열이 정렬되어 있습니다.

웹훅 페이로드나 외부 API 응답을 json.Unmarshal로 받을 타입이 필요할 때, net/http·Gin·Echo 핸들러의 요청 바디 struct를 만들 때, 설정 파일을 struct로 읽는 CLI를 만들 때 쓰기 좋습니다.

사용 방법

  1. JSON을 붙여넣습니다. 여러 행이 있는 배열을 넣으면 일부 행에만 있는 필드를 찾아 omitempty를 붙입니다.
  2. struct 이름에 최상위 struct 이름을 적습니다(기본값 Root). 주소의 ?name=에 남습니다.
  3. 결과를 .go 파일에 붙여넣고 package 선언을 추가합니다. 시간 필드가 있으면 import "time"이 함께 나옵니다.
  4. var ev WebhookEvent; err := json.Unmarshal(body, &ev)처럼 사용합니다.

예시

입력 (JSON)
{
  "event_id": "evt_1Pq",
  "type": "invoice.paid",
  "created_at": "2024-05-01T03:15:00Z",
  "amount_cents": 4999,
  "customer": { "id": "cus_9", "email": "kim@example.com" },
  "retry_count": null
}
출력 (Go)
import "time"

type WebhookEvent struct {
	EventID     string    `json:"event_id"`
	Type        string    `json:"type"`
	CreatedAt   time.Time `json:"created_at"`
	AmountCents int       `json:"amount_cents"`
	Customer    Customer  `json:"customer"`
	RetryCount  any       `json:"retry_count,omitempty"`
}

type Customer struct {
	ID    string `json:"id"`
	Email string `json:"email"`
}

event_id는 golint 약어 규칙에 따라 EventID가 되었고, RFC 3339 형식인 created_at은 time.Time으로 추론되어 import "time"이 추가됐습니다. 값이 null인 retry_count는 타입을 알 수 없어 any이며 omitempty가 붙었습니다.

지원 기능

  • 필드마다 json:"원래키" 태그를 붙이고, 일부 행에 없거나 null인 필드에는 ,omitempty를 추가합니다.
  • 선택 필드 중 값 타입(int, string, bool, struct, time.Time)은 포인터(*int)로 만들어 "없음"과 0값을 구분합니다. 슬라이스와 any는 원래 nil이 될 수 있어 포인터를 쓰지 않습니다.
  • 숫자: 32비트 범위의 정수는 int, 넘으면 int64, 소수가 있으면 float64.
  • 2024-05-01T03:15:00Z 같은 RFC 3339 문자열은 time.Time으로 추론합니다.
  • user_id → UserID, home_url → HomeURL처럼 golint 공통 약어를 대문자로 유지하고, 숫자로 시작하는 키는 Field 접두어를 붙입니다.
  • ""처럼 Go json 태그에 쓸 수 없는 키는 필드를 만들지 않고 struct 위 주석으로 알려 줍니다.
  • 최상위가 객체 배열이면 원소를 struct로 만들고 []Root로 언마샬하라는 주석을 답니다.

사용 사례

웹훅 수신 핸들러

결제·Git 호스팅 서비스가 보내는 이벤트 예시를 넣어 struct를 만들고 json.NewDecoder(r.Body).Decode(&ev)로 받으면, map[string]any에서 타입 단언을 반복하지 않아도 됩니다.

Gin·Echo 요청 바인딩

c.ShouldBindJSON(&req)에 넘길 struct를 클라이언트 요청 예시로 만들고, 필요한 필드에 binding:"required" 태그만 추가하면 됩니다.

JSON 설정 파일을 읽는 CLI

config.json을 넣어 struct를 만들어 두면 os.ReadFile 후 한 번의 json.Unmarshal로 설정 전체를 타입 있는 값으로 읽을 수 있습니다.

주의사항

  • time.Time은 RFC 3339 형식만 인식합니다. 2024-05-01 03:15:00이나 유닉스 타임스탬프는 string·int로 남습니다.
  • Go의 json.Unmarshal은 기본적으로 모르는 키를 무시하고 키 대소문자도 느슨하게 맞춥니다. 엄격하게 하려면 Decoder.DisallowUnknownFields()를 쓰세요.
  • int는 64비트 플랫폼에서 64비트지만, 32비트 범위를 넘는 예시 값이 있을 때만 int64로 명시합니다. ID처럼 커질 수 있는 값은 직접 int64로 바꾸는 편이 안전합니다.
  • 중첩 struct는 모두 최상위 타입으로 따로 정의됩니다(익명 inline struct를 쓰지 않음).
  • 타입이 섞인 값이나 null만 있는 값은 any가 되므로 실제 타입이 정해지면 바꿔 주세요.

자주 묻는 질문

선택 필드가 왜 *int 같은 포인터인가요?

Go에서 int 필드는 키가 없을 때 0이 되어, 실제 값 0과 구분할 수 없습니다. 포인터로 두면 키가 없거나 null이면 nil이므로 둘을 구분할 수 있고, omitempty와 함께 다시 직렬화할 때 키를 생략합니다.

필드 이름을 소문자로 바꾸면 안 되나요?

encoding/json은 exported(대문자로 시작하는) 필드만 읽고 씁니다. 소문자 필드는 태그가 있어도 무시되므로 이름은 대문자로 두고, JSON 키는 태그로 지정하는 것이 Go의 방식입니다.

retry_count처럼 null인 필드가 any로 나와요.

예시에 null만 있으면 실제 타입을 추론할 근거가 없습니다. 다른 응답에서 값이 있는 예시를 함께 배열로 넣거나, 결과에서 *int처럼 직접 고쳐 주세요.

Go struct를 다시 JSON 예시로 만들 수 있나요?

위쪽 탭의 Go struct → JSON 페이지에서 struct 정의를 붙여넣으면 태그를 읽어 예시 JSON을 만들어 줍니다.