I-paste ang mga Go struct definition at makakakuha ka ng halimbawang JSON document na binuo gamit ang parehong rules na ina-apply ng encoding/json sa pag-marshal: mga tag name na json:"...", mga field na itinago gamit ang -, ang ,string option, mga unexported na lowercase field at mga flattened na embedded struct.
Magagamit ito sa paggawa ng curl body mula sa isang Gin, Echo o net/http request struct, sa paghahanda ng sample para sa gRPC-Gateway o REST docs, at sa pagtukoy ng mga field na hindi lumalabas ang key na inaasahan mo dahil sa tag nila.
type Xxx struct { ... }. Ayos lang ang mga grouped na type ( ... ) block at maraming struct nang sabay.null ang mga type mula sa external package na wala sa input (gaya ng decimal.Decimal).curl -d, Postman body o isang handler test na batay sa 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
}Direktang nag-aambag ng id at created_at sa Job ang embedded na Base, at nagiging string na "0" sa halip na numero ang Attempts na may tag na ,string. Tinatanggal ang Token (tag na -) at ang unexported na lastErr, habang napapanatili ng walang tag na Done ang Go field name nito bilang key. Ipinapakita ng time.Time ang zero value ng Go, 0001-01-01T00:00:00Z.
json:"name" bilang key, at bumabalik sa eksaktong field name kapag walang tag.json:"-" at mga unexported na lowercase field; pinapanatili ng json:"-," ang field sa ilalim ng literal na key na -.,string, binabalot bilang string ang mga numeric at boolean field, gaya ng "0" at "false".*int, *Profile), at sinusunod ng mga defined type gaya ng type Status string ang underlying type nila.[]byte, gumagamit ng key na "0" ang map[int]T, ang time.Duration ay ang nanosecond integer na 0, at null ang interface{}/any.Children []Node. Suportado ang mga anonymous na nested struct field.I-paste ang struct na bina-bind mo gamit ang c.ShouldBindJSON(&req), i-generate ang body, at tawagin ang endpoint gamit ang httptest.NewRequest o curl. Dahil direktang galing sa mga tag ang mga key, mas maliit ang tsansa ng binding mismatch.
Agad na halata sa output ang halo-halong tag na json:"user_id" at json:"userId", o ang nakalimutang tag na naglalabas ng uppercase na key na UserID.
Ibigay sa mga frontend o Python consumer ang JSON mula sa Go response struct mo; maibabalik nila ito sa mga model gamit ang mga tool gaya ng JSON → TypeScript o JSON → Python.
omitempty; sa totoong marshaling, tinatanggal sila kapag zero value ang laman.null ang isang nil pointer, pero ang kasong may laman ang ipinapakita ng sample.MarshalJSON() at ang totoong laman ng json.RawMessage.omitzero ng Go 1.24 at ang behavior ng encoding/json/v2.Ginagamit ng encoding/json ang exported na field name nang eksakto, kaya nagiging "Done" ang Done bool. Case-insensitive ang matching kapag nagde-decode sa Go, pero hindi ganoon ang mga client sa ibang language, kaya mas ligtas ang mga explicit na tag.
time.Time?Ang zero na time.Time ng Go ay 0001-01-01 00:00:00 UTC, na nagma-marshal sa RFC 3339 bilang 0001-01-01T00:00:00Z. Kaya iba ito sa mga petsang 1970 sa ibang page na → JSON.
json:",string"?Kadalasan para sa malalaking int64 ID na hindi eksaktong kayang i-represent ng JavaScript, kaya ipinapadala sila bilang string. "0" ang ipinapakita ng sample, kaya malinaw sa mga client na string ang matatanggap nila.
Gamitin ang page na JSON → Go struct. Kapag ibinalik ang output nito sa page na ito, mabilis mong masusuri kung napapanatili ng round trip ang mga orihinal na key.