Cole definições de struct em Go e receba um JSON de exemplo montado com as mesmas regras que o encoding/json aplica no marshal: nomes das tags json:"...", campos escondidos com -, a opção ,string, campos não exportados em minúscula e structs embutidos achatados.
É útil para gerar um body de curl a partir de um struct de request do Gin, Echo ou net/http, preparar exemplos para gRPC-Gateway ou documentação REST e achar campos cujas tags não geram a chave que você esperava.
type Xxx struct { ... }. Blocos agrupados type ( ... ) e vários structs de uma vez funcionam.decimal.Decimal) viram null.curl -d, um body do Postman ou um teste de handler baseado em 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
}O Base embutido contribui com id e created_at direto em Job, e Attempts, marcado com ,string, vira a string "0" em vez de número. Token (tag -) e o lastErr não exportado são descartados, enquanto Done, sem tag, mantém o nome do campo Go como chave. time.Time mostra o zero value do Go, 0001-01-01T00:00:00Z.
json:"name" como chave e, quando não há tag, cai no nome exato do campo.json:"-" e campos não exportados em minúscula; json:"-," mantém o campo com a chave literal -.,string, campos numéricos e booleanos são embrulhados como strings como "0" e "false".*int, *Profile) são preenchidos com o tipo apontado, e tipos definidos como type Status string seguem o tipo subjacente.[]byte vira uma string Base64 (vazia), map[int]T usa a chave "0", time.Duration é o inteiro de nanossegundos 0, e interface{}/any são null.Children []Node param num array vazio. Campos de struct aninhado anônimo são suportados.Cole o struct que você faz bind com c.ShouldBindJSON(&req), gere o body e chame o endpoint via httptest.NewRequest ou curl. Como as chaves vêm direto das tags, erros de binding ficam menos prováveis.
Tags misturadas json:"user_id" e json:"userId", ou uma tag esquecida que vaza uma chave UserID em maiúscula, ficam óbvias logo de cara na saída.
Entregue a quem consome no frontend ou em Python o JSON do seu struct de resposta em Go; eles podem transformá-lo de volta em models com ferramentas como JSON → TypeScript ou JSON → Python.
omitempty sempre aparecem no exemplo; o marshal real os descarta quando têm o zero value.nil vira null no marshal, mas o exemplo mostra o caso preenchido.MarshalJSON() customizado e o conteúdo real de json.RawMessage não têm como ser conhecidos e não são refletidos.omitzero do Go 1.24 e o comportamento do encoding/json/v2, não são cobertas.O encoding/json usa o nome exportado do campo literalmente, então Done bool vira "Done". O decode em Go compara sem diferenciar maiúsculas, mas clients em outras linguagens não, então tags explícitas são mais seguras.
time.Time aparece com o ano 0001?O zero value de time.Time no Go é 0001-01-01 00:00:00 UTC, que no marshal em RFC 3339 vira 0001-01-01T00:00:00Z. Por isso ele é diferente das datas de 1970 das outras páginas → JSON.
json:",string" é útil?Principalmente para IDs int64 grandes que o JavaScript não consegue representar com exatidão, para que trafeguem como string. O exemplo mostra "0", deixando claro para os clients que eles vão receber uma string.
Use a página JSON → Go struct. Colocar a saída dela de volta nesta página é um jeito rápido de conferir se a ida e volta mantém as chaves originais.