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

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

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

Вставьте определения struct на Go и получите пример JSON-документа, построенный по тем же правилам, что применяет encoding/json при маршалинге: имена из тегов json:"...", поля, скрытые через -, опция ,string, неэкспортируемые поля со строчной буквы и «развёрнутые» встроенные структуры.

Удобно, чтобы получить тело для curl из структуры запроса Gin, Echo или net/http, подготовить примеры для gRPC-Gateway или REST-документации и найти поля, теги которых дают не тот ключ, что вы ожидали.

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

  1. Вставьте объявления type Xxx struct { ... }. Сгруппированные блоки type ( ... ) и несколько структур сразу — не проблема.
  2. Если поле использует другую структуру, добавьте и её определение. Типы из внешних пакетов, которых нет во вводе (например, decimal.Decimal), становятся null.
  3. Опций нет: JSON верхнего уровня строится из первой структуры, на которую не ссылается другой тип, так что поставьте нужную первой или уберите посторонние структуры.
  4. Скопируйте результат в curl -d, тело запроса в Postman или тест обработчика на основе httptest.

Пример

Вход (Go struct)
type Base struct {
	ID        string    `json:"id"`
	CreatedAt time.Time `json:"created_at"`
}

type Job struct {
	Base
	Queue      string            `json:"queue"`
	Attempts   int               `json:"attempts,string"`
	Labels     map[string]string `json:"labels,omitempty"`
	TimeoutSec *int              `json:"timeout_sec,omitempty"`
	Token      string            `json:"-"`
	Done       bool
	lastErr    error
}
Результат (JSON)
{
  "id": "",
  "created_at": "0001-01-01T00:00:00Z",
  "queue": "",
  "attempts": "0",
  "labels": {
    "key": ""
  },
  "timeout_sec": 0,
  "Done": false
}

Встроенная Base добавляет id и created_at прямо в Job, а Attempts с тегом ,string становится строкой "0" вместо числа. Token (тег -) и неэкспортируемое lastErr отбрасываются, а Done без тега сохраняет имя поля Go в качестве ключа. time.Time показывает нулевое значение Go — 0001-01-01T00:00:00Z.

Возможности

  • Использует тег json:"name" как ключ, а без тега — точное имя поля.
  • Пропускает поля json:"-" и неэкспортируемые поля со строчной буквы; json:"-," сохраняет поле под буквальным ключом -.
  • С ,string числовые и булевы поля оборачиваются в строки вроде "0" и "false".
  • Встроенные структуры без тега разворачиваются в родителя, при совпадении имён побеждают внешние поля; встроенная структура с тегом становится вложенным объектом под этим именем.
  • Указатели (*int, *Profile) заполняются типом, на который указывают, а определённые типы вроде type Status string следуют своему базовому типу.
  • []byte становится (пустой) строкой Base64, map[int]T использует ключ "0", time.Duration — целое число наносекунд 0, а interface{}/any — null.
  • Самоссылающиеся структуры вроде Children []Node обрываются на пустом массиве. Поля с анонимными вложенными структурами поддерживаются.

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

Тела запросов для тестов обработчиков

Вставьте структуру, которую привязываете через c.ShouldBindJSON(&req), сгенерируйте тело и вызовите эндпоинт через httptest.NewRequest или curl. Поскольку ключи берутся прямо из тегов, ошибок привязки становится меньше.

Поиск ошибок в тегах

Смесь тегов json:"user_id" и json:"userId" или забытый тег, из-за которого наружу утекает ключ UserID с заглавной, сразу видны в выводе.

Общая схема с клиентами на других языках

Отдайте фронтенду или потребителям на Python JSON из вашей структуры ответа Go; они смогут превратить его обратно в модели инструментами вроде JSON → TypeScript или JSON → Python.

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

  • Поля с omitempty в примере показываются всегда; при реальном маршалинге они отбрасываются, если содержат нулевое значение.
  • Указатель nil маршалится как null, но в примере показан заполненный вариант.
  • Типы с собственным MarshalJSON() и фактическое содержимое json.RawMessage узнать нельзя, поэтому они не отражаются.
  • Новые опции вроде omitzero из Go 1.24 и поведение encoding/json/v2 не поддерживаются.

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

Какой ключ получает поле без тега?

encoding/json использует имя экспортируемого поля дословно, так что Done bool становится "Done". Декодирование в Go сопоставляет ключи без учёта регистра, а клиенты на других языках — нет, поэтому явные теги надёжнее.

Почему у time.Time стоит 0001 год?

Нулевое значение time.Time в Go — 0001-01-01 00:00:00 UTC, которое в RFC 3339 маршалится как 0001-01-01T00:00:00Z. Поэтому оно отличается от дат 1970 года на других страницах → JSON.

Когда полезен json:",string"?

В основном для больших ID типа int64, которые JavaScript не может представить точно, — они передаются строками. В примере показано "0", и клиентам сразу понятно, что они получат строку.

Мне нужно обратное: структуры Go из JSON.

Используйте страницу JSON → Go struct. Если подать её вывод обратно на эту страницу, можно быстро проверить, что после полного круга сохраняются исходные ключи.