Ubah struct Go menjadi JSON!

Masukkan struct Go untuk membuat contoh JSON sesuai tag json-nya! Mendukung Go (Golang) struct, json tags. Berguna untuk dokumentasi API dan body request uji (mock request body).
Go struct
Hasil
 

Ubah struct Go menjadi JSON!

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.

Cara menggunakan

  1. Tempel deklarasi type Xxx struct { ... }. Blok type ( ... ) yang dikelompokkan dan beberapa struct sekaligus tidak masalah.
  2. Jika sebuah field memakai struct lain, sertakan juga definisinya. Tipe dari package eksternal yang tidak ada di input (seperti decimal.Decimal) menjadi null.
  3. Tidak ada opsi: struct pertama yang tidak direferensikan tipe lain menjadi JSON tingkat atas, jadi letakkan yang Anda inginkan di urutan pertama atau buang struct yang tidak berkaitan.
  4. Salin hasilnya ke curl -d, body Postman, atau test handler berbasis httptest.

Contoh

Input (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
}
Output (JSON)
{
  "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.

Fitur yang didukung

  • Memakai tag json:"name" sebagai key, dan kembali ke nama field persisnya jika tidak ada tag.
  • Melewati field json:"-" dan field huruf kecil yang tidak diekspor; json:"-," mempertahankan field di bawah key literal -.
  • Dengan ,string, field number dan boolean dibungkus sebagai string seperti "0" dan "false".
  • Embedded struct tanpa tag diratakan ke dalam parent, dan field luar menang jika namanya bentrok; embedded struct yang diberi tag menjadi objek bersarang dengan nama tersebut.
  • Pointer (*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.
  • Struct yang mereferensikan dirinya sendiri seperti Children []Node berhenti di array kosong. Field anonymous nested struct didukung.

Kasus penggunaan

Body request untuk test handler

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.

Menemukan kesalahan tag

Tag json:"user_id" dan json:"userId" yang tercampur, atau tag yang terlupa sehingga key huruf kapital UserID bocor, langsung terlihat sekilas di output.

Berbagi skema dengan client di bahasa lain

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.

Catatan dan batasan

  • Field omitempty selalu ditampilkan di contoh; marshaling sebenarnya membuangnya ketika berisi zero value.
  • Pointer nil di-marshal sebagai null, tetapi contoh menampilkan kasus yang terisi.
  • Tipe dengan MarshalJSON() kustom dan isi sebenarnya dari json.RawMessage tidak bisa diketahui sehingga tidak tercermin.
  • Opsi yang lebih baru seperti omitzero di Go 1.24 dan perilaku encoding/json/v2 tidak dicakup.

FAQ

Key apa yang didapat field tanpa tag?

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.

Mengapa 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.

Kapan 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.

Saya ingin kebalikannya: struct Go dari JSON.

Gunakan halaman JSON → Go struct. Memasukkan output-nya kembali ke halaman ini adalah cara cepat untuk memeriksa bahwa round trip mempertahankan key aslinya.