Преобразуйте JSON в структуры Go!

Введите JSON, чтобы преобразовать его в структуры Go с тегами json! Поддержка: Go (Golang) struct, json tags.
JSON
Результат

Преобразуйте JSON в структуры Go!

Преобразует JSON в определения структур Go с тегами encoding/json. Имена полей следуют правилу экспортируемых имён Go и списку инициализмов golint (ID, URL, API, ...), а колонки выровнены так, будто код прошёл через gofmt.

Полезно, когда нужен тип, в который можно сделать json.Unmarshal payload вебхука или ответа API, структура тела запроса для обработчиков net/http, Gin или Echo, либо структура конфигурации для CLI.

Как пользоваться

  1. Вставьте JSON. Если это массив из нескольких строк, поля, отсутствующие в некоторых из них, распознаются и получают тег omitempty.
  2. Введите имя структуры верхнего уровня в Имя структуры (по умолчанию Root); оно сохраняется в URL как ?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 становится EventID по правилу инициализмов golint, а created_at — строка RFC 3339 — распознаётся как time.Time, что добавляет import "time". retry_count равен null, поэтому его тип неизвестен: он становится any с omitempty.

Возможности

  • Тег json:"originalKey" на каждом поле плюс ,omitempty для полей, отсутствующих в части строк или содержащих null.
  • Необязательные типы-значения (int, string, bool, структуры, time.Time) становятся указателями (*int), чтобы «отсутствует» отличалось от нулевого значения. Срезы и any и так могут быть nil и остаются без указателя.
  • Числа: int для 32-битных целых, int64 для больших, float64, если встречаются дробные.
  • Строки RFC 3339 вроде 2024-05-01T03:15:00Z распознаются как time.Time.
  • Распространённые инициализмы остаются в верхнем регистре (user_id → UserID, home_url → HomeURL); ключи, начинающиеся с цифры, получают префикс Field.
  • Ключи, которые не могут стоять в json-теге Go, например "", пропускаются и перечисляются в комментарии над структурой.
  • Массив объектов верхнего уровня даёт структуру для элемента и комментарий о том, что демаршалить нужно в []Root.

Сценарии использования

Приёмники вебхуков

Постройте структуру по примеру события от платёжного сервиса или Git-хостинга и декодируйте его через json.NewDecoder(r.Body).Decode(&ev) вместо многократных type assertion по map[string]any.

Привязка запросов в Gin или Echo

Сгенерируйте структуру для c.ShouldBindJSON(&req) по образцу клиентского запроса, затем добавьте теги binding:"required" там, где нужно.

CLI, читающие JSON-конфиг

Один раз превратите config.json в структуру — и единственный json.Unmarshal после os.ReadFile даст весь конфиг в виде типизированных значений.

Примечания и ограничения

  • time.Time распознаётся только для строк RFC 3339; значения вроде 2024-05-01 03:15:00 или Unix-метки времени остаются string или int.
  • json.Unmarshal по умолчанию игнорирует неизвестные ключи и сопоставляет ключи без учёта регистра. Для строгого декодирования используйте Decoder.DisallowUnknownFields().
  • На 64-битных платформах int 64-битный, но int64 пишется, только если значение в примере превышает 32 бита. Для растущих ID надёжнее самим поменять тип на int64.
  • Все вложенные структуры определяются как отдельные типы верхнего уровня; анонимные встроенные структуры не используются.
  • Значения смешанного типа и значения, которые всегда null, становятся any; замените их, когда реальный тип станет известен.

Частые вопросы

Почему необязательные поля — указатели вроде *int?

Обычное поле int равно 0, если ключа нет, и это не отличить от настоящего 0. Указатель равен nil, если ключ отсутствует или равен null, а вместе с omitempty ключ опускается при повторном маршалинге.

Можно ли сделать имена полей строчными?

encoding/json читает и пишет только экспортируемые поля (с заглавной буквы); поля со строчной игнорируются даже с тегом. В Go имена остаются с заглавной, а ключ JSON указывается в теге.

Поле со значением null, как retry_count, получилось any.

Когда в примере только null, выводить тип не из чего. Добавьте в массив ещё один ответ с реальным значением и преобразуйте оба или поменяйте тип вручную, например на *int.

Можно ли превратить структуру Go обратно в пример JSON?

Да. Вставьте структуру во вкладку Go struct → JSON вверху; она прочитает теги и выдаст пример JSON.