Вставьте определения struct на Go и получите пример JSON-документа, построенный по тем же правилам, что применяет encoding/json при маршалинге: имена из тегов json:"...", поля, скрытые через -, опция ,string, неэкспортируемые поля со строчной буквы и «развёрнутые» встроенные структуры.
Удобно, чтобы получить тело для curl из структуры запроса Gin, Echo или net/http, подготовить примеры для gRPC-Gateway или REST-документации и найти поля, теги которых дают не тот ключ, что вы ожидали.
type Xxx struct { ... }. Сгруппированные блоки type ( ... ) и несколько структур сразу — не проблема.decimal.Decimal), становятся null.curl -d, тело запроса в Postman или тест обработчика на основе httptest.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
}{
"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", и клиентам сразу понятно, что они получат строку.
Используйте страницу JSON → Go struct. Если подать её вывод обратно на эту страницу, можно быстро проверить, что после полного круга сохраняются исходные ключи.