Converta structs Go em JSON!

Insira structs Go para gerar um JSON de exemplo conforme suas tags json! Compatível com Go (Golang) struct, json tags. Útil para documentar APIs e corpos de requisição de teste (mock request body).
Go struct
Resultado
 

Converta structs Go em JSON!

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.

Como usar

  1. Cole declarações type Xxx struct { ... }. Blocos agrupados type ( ... ) e vários structs de uma vez funcionam.
  2. Se um campo usa outro struct, inclua a definição dele também. Tipos de pacotes externos que não estão na entrada (como decimal.Decimal) viram null.
  3. Não há opções: o primeiro struct que não é referenciado por outro tipo vira o JSON de nível mais alto, então coloque o que você quer primeiro ou deixe de fora structs não relacionados.
  4. Copie o resultado para curl -d, um body do Postman ou um teste de handler baseado em httptest.

Exemplo

Entrada (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
}
Saída (JSON)
{
  "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.

Recursos suportados

  • Usa a tag json:"name" como chave e, quando não há tag, cai no nome exato do campo.
  • Pula campos json:"-" e campos não exportados em minúscula; json:"-," mantém o campo com a chave literal -.
  • Com ,string, campos numéricos e booleanos são embrulhados como strings como "0" e "false".
  • Structs embutidos sem tag são achatados no pai, com os campos de fora vencendo em caso de conflito de nome; um struct embutido com tag vira um objeto aninhado com esse nome.
  • Ponteiros (*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.
  • Structs autorreferentes como Children []Node param num array vazio. Campos de struct aninhado anônimo são suportados.

Casos de uso

Bodies de request para testes de handler

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.

Achar erros nas tags

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.

Compartilhar um schema com clients em outras linguagens

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.

Observações e limitações

  • Campos omitempty sempre aparecem no exemplo; o marshal real os descarta quando têm o zero value.
  • Um ponteiro nil vira null no marshal, mas o exemplo mostra o caso preenchido.
  • Tipos com MarshalJSON() customizado e o conteúdo real de json.RawMessage não têm como ser conhecidos e não são refletidos.
  • Opções mais novas, como o omitzero do Go 1.24 e o comportamento do encoding/json/v2, não são cobertas.

Perguntas frequentes

Que chave recebe um campo sem tag?

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.

Por que 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.

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

Quero o contrário: structs Go a partir de JSON.

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.