Tempel definisi struct Go dan dapatkan contoh dokumen JSON yang dibangun dengan aturan yang sama seperti yang diterapkan encoding/json saat marshaling: nama dari tag json:"...", field yang disembunyikan dengan -, opsi ,string, field huruf kecil yang tidak diekspor, dan embedded struct yang diratakan.
Alat ini praktis untuk membuat body curl dari struct request Gin, Echo, atau net/http, menyiapkan contoh untuk gRPC-Gateway atau dokumentasi REST, dan menemukan field yang tag-nya tidak menghasilkan key yang Anda harapkan.
type Xxx struct { ... }. Blok type ( ... ) yang dikelompokkan dan beberapa struct sekaligus tidak masalah.decimal.Decimal) menjadi null.curl -d, body Postman, atau test handler berbasis 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
}Embedded Base menyumbangkan id dan created_at langsung ke Job, dan Attempts yang diberi tag ,string menjadi string "0", bukan number. Token (tag -) dan lastErr yang tidak diekspor dibuang, sedangkan Done yang tanpa tag memakai nama field Go-nya sebagai key. time.Time menampilkan zero value Go, 0001-01-01T00:00:00Z.
json:"name" sebagai key, dan kembali ke nama field persisnya jika tidak ada tag.json:"-" dan field huruf kecil yang tidak diekspor; json:"-," mempertahankan field di bawah key literal -.,string, field number dan boolean dibungkus sebagai string seperti "0" dan "false".*int, *Profile) diisi dengan tipe yang ditunjuknya, dan defined type seperti type Status string mengikuti underlying type-nya.[]byte menjadi string Base64 (kosong), map[int]T memakai key "0", time.Duration menjadi integer nanodetik 0, dan interface{}/any menjadi null.Children []Node berhenti di array kosong. Field anonymous nested struct didukung.Tempel struct yang Anda bind dengan c.ShouldBindJSON(&req), buat body-nya, lalu panggil endpoint lewat httptest.NewRequest atau curl. Karena key diambil langsung dari tag, ketidakcocokan binding lebih kecil kemungkinannya.
Tag json:"user_id" dan json:"userId" yang tercampur, atau tag yang terlupa sehingga key huruf kapital UserID bocor, langsung terlihat sekilas di output.
Berikan JSON dari struct respons Go Anda ke konsumen frontend atau Python; mereka bisa mengubahnya kembali menjadi model dengan tool seperti JSON → TypeScript atau JSON → Python.
omitempty selalu ditampilkan di contoh; marshaling sebenarnya membuangnya ketika berisi zero value.nil di-marshal sebagai null, tetapi contoh menampilkan kasus yang terisi.MarshalJSON() kustom dan isi sebenarnya dari json.RawMessage tidak bisa diketahui sehingga tidak tercermin.omitzero di Go 1.24 dan perilaku encoding/json/v2 tidak dicakup.encoding/json memakai nama field yang diekspor apa adanya, jadi Done bool menjadi "Done". Decoding di Go mencocokkan tanpa membedakan huruf besar-kecil, tetapi client di bahasa lain tidak, jadi tag eksplisit lebih aman.
time.Time diisi tahun 0001?Zero time.Time di Go adalah 0001-01-01 00:00:00 UTC, yang di-marshal dalam RFC 3339 sebagai 0001-01-01T00:00:00Z. Itulah sebabnya berbeda dengan tanggal 1970 di halaman → JSON lainnya.
json:",string" berguna?Terutama untuk ID int64 besar yang tidak bisa direpresentasikan JavaScript dengan tepat, sehingga dikirim sebagai string. Contoh menampilkan "0", yang memperjelas bagi client bahwa mereka akan menerima string.
Gunakan halaman JSON → Go struct. Memasukkan output-nya kembali ke halaman ini adalah cara cepat untuk memeriksa bahwa round trip mempertahankan key aslinya.