Konversikan JSON menjadi definisi struct Go dengan tag encoding/json. Nama field mengikuti aturan nama ekspor Go dan daftar initialism golint (ID, URL, API, ...), dan kolom-kolomnya disejajarkan seolah kode sudah melewati gofmt.
Berguna ketika Anda butuh tipe untuk json.Unmarshal payload webhook atau respons API, struct body request untuk handler net/http, Gin, atau Echo, atau struct config untuk sebuah CLI.
omitempty.Nama struct (default Root); nama ini tersimpan di URL sebagai ?name=..go dan tambahkan klausa package. Jika ada field waktu yang ditemukan, import "time" ikut disertakan.var ev WebhookEvent; err := json.Unmarshal(body, &ev).{
"event_id": "evt_1Pq",
"type": "invoice.paid",
"created_at": "2024-05-01T03:15:00Z",
"amount_cents": 4999,
"customer": { "id": "cus_9", "email": "kim@example.com" },
"retry_count": null
}import "time"
type WebhookEvent struct {
EventID string `json:"event_id"`
Type string `json:"type"`
CreatedAt time.Time `json:"created_at"`
AmountCents int `json:"amount_cents"`
Customer Customer `json:"customer"`
RetryCount any `json:"retry_count,omitempty"`
}
type Customer struct {
ID string `json:"id"`
Email string `json:"email"`
}
event_id menjadi EventID sesuai aturan initialism golint, dan created_at, sebuah string RFC 3339, disimpulkan sebagai time.Time, yang menambahkan import "time". retry_count bernilai null, jadi tipenya tidak diketahui: menjadi any dengan omitempty.
json:"originalKey" di setiap field, ditambah ,omitempty untuk field yang tidak ada di sebagian baris atau berisi null.int, string, bool, struct, time.Time) menjadi pointer (*int) agar "tidak ada" berbeda dari zero value. Slice dan any sudah bisa nil sehingga tetap bukan pointer.int untuk integer 32-bit, int64 jika melebihinya, float64 jika muncul desimal.2024-05-01T03:15:00Z disimpulkan sebagai time.Time.user_id → UserID, home_url → HomeURL); key yang diawali angka diberi prefix Field."", dilewati dan dicantumkan di komentar di atas struct.[]Root.Buat struct dari contoh event yang dikirim layanan pembayaran atau Git hosting dan decode dengan json.NewDecoder(r.Body).Decode(&ev), alih-alih type assertion berulang pada map[string]any.
Buat struct untuk c.ShouldBindJSON(&req) dari contoh request client, lalu tambahkan tag binding:"required" di tempat yang diperlukan.
Ubah config.json menjadi struct sekali saja, dan satu json.Unmarshal setelah os.ReadFile memberi Anda seluruh config sebagai nilai bertipe.
time.Time hanya disimpulkan untuk string RFC 3339; nilai seperti 2024-05-01 03:15:00 atau Unix timestamp tetap string atau int.json.Unmarshal secara default mengabaikan key yang tidak dikenal dan mencocokkan key tanpa membedakan huruf besar-kecil. Gunakan Decoder.DisallowUnknownFields() jika Anda ingin decoding yang ketat.int berukuran 64-bit di platform 64-bit, tetapi int64 hanya ditulis jika nilai contoh melebihi 32 bit. Untuk ID yang bisa terus bertambah, lebih aman menggantinya sendiri ke int64.null menjadi any; ganti setelah tipe sebenarnya diketahui.*int?Field int biasa bernilai 0 ketika key-nya tidak ada, sehingga tidak bisa dibedakan dari 0 yang sebenarnya. Pointer bernilai nil ketika key tidak ada atau null, dan bersama omitempty key tersebut dihilangkan saat Anda melakukan marshal lagi.
encoding/json hanya membaca dan menulis field yang diekspor (berhuruf kapital); field huruf kecil diabaikan meskipun diberi tag. Di Go, nama tetap berhuruf kapital dan key JSON ditaruh di tag.
null seperti retry_count keluar sebagai any.Jika contoh hanya berisi null, tidak ada yang bisa dijadikan dasar penyimpulan tipe. Tambahkan respons lain yang punya nilai sebenarnya ke dalam array lalu konversikan keduanya, atau ubah manual menjadi sesuatu seperti *int.
Bisa. Tempel struct ke tab Go struct → JSON di bagian atas; tab itu membaca tag dan menghasilkan contoh JSON.