Dán định nghĩa struct của Go để nhận một tài liệu JSON mẫu được dựng theo đúng quy tắc mà encoding/json áp dụng khi marshal: tên trong tag json:"...", field bị ẩn bằng -, option ,string, field chữ thường không export và struct nhúng được làm phẳng.
Công cụ tiện cho việc tạo body curl từ struct request của Gin, Echo hay net/http, chuẩn bị mẫu cho gRPC-Gateway hoặc tài liệu REST, và phát hiện những field có tag không cho ra key như bạn mong đợi.
type Xxx struct { ... }. Khối nhóm type ( ... ) và nhiều struct cùng lúc đều được.decimal.Decimal) thành null.curl -d, body của Postman hoặc test handler dựa trên 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 được nhúng đóng góp trực tiếp id và created_at vào Job, và Attempts, có tag ,string, thành chuỗi "0" thay vì số. Token (tag -) và lastErr không export bị bỏ, còn Done không có tag giữ tên field Go làm key. time.Time hiện giá trị zero của Go, 0001-01-01T00:00:00Z.
json:"name" làm key, nếu không có tag thì dùng đúng tên field.json:"-" và field chữ thường không export; json:"-," giữ field dưới key nguyên văn là -.,string, field số và boolean được bọc thành chuỗi như "0" và "false".*int, *Profile) được điền theo kiểu mà nó trỏ tới, và defined type như type Status string theo kiểu nền của nó.[]byte thành chuỗi Base64 (rỗng), map[int]T dùng key "0", time.Duration là số nguyên nano giây 0, còn interface{}/any là null.Children []Node dừng ở một mảng rỗng. Field struct lồng ẩn danh được hỗ trợ.Dán struct bạn bind bằng c.ShouldBindJSON(&req), tạo body, rồi gọi endpoint qua httptest.NewRequest hoặc curl. Vì key lấy thẳng từ tag, khả năng bind lệch sẽ thấp hơn.
Tag json:"user_id" và json:"userId" dùng lẫn lộn, hay một tag bị quên làm lộ ra key viết hoa UserID, đều thấy ngay khi nhìn output.
Đưa cho phía frontend hoặc Python JSON từ struct response Go của bạn; họ có thể biến nó lại thành model bằng các công cụ như JSON → TypeScript hay JSON → Python.
omitempty luôn được hiện trong mẫu; khi marshal thật chúng bị bỏ nếu đang giữ giá trị zero.nil được marshal thành null, nhưng mẫu hiện trường hợp đã có giá trị.MarshalJSON() tùy biến và nội dung thực của json.RawMessage không thể biết trước nên không được phản ánh.omitzero của Go 1.24 và hành vi của encoding/json/v2 không được hỗ trợ.encoding/json dùng nguyên văn tên field đã export, nên Done bool thành "Done". Khi decode trong Go việc so khớp không phân biệt hoa/thường, nhưng client ở ngôn ngữ khác thì có, nên tag tường minh an toàn hơn.
time.Time lại là năm 0001?Giá trị zero của time.Time trong Go là 0001-01-01 00:00:00 UTC, được marshal theo RFC 3339 thành 0001-01-01T00:00:00Z. Đó là lý do nó khác với ngày năm 1970 trên các trang chuyển sang JSON khác.
json:",string" có ích?Chủ yếu cho ID int64 lớn mà JavaScript không biểu diễn chính xác được, nên chúng được truyền dưới dạng chuỗi. Mẫu hiện "0", cho client thấy rõ rằng họ sẽ nhận chuỗi.
Hãy dùng trang JSON → Go struct. Đưa output của trang đó trở lại trang này là cách nhanh để kiểm tra vòng chuyển đổi có giữ nguyên key gốc hay không.