Pega definiciones de struct de Go y obtén un documento JSON de ejemplo construido con las mismas reglas que aplica encoding/json al hacer marshal: nombres de los tags json:"...", campos ocultos con -, la opción ,string, campos en minúscula no exportados y structs embebidos aplanados.
Es práctico para producir el body de un curl a partir de un struct de petición de Gin, Echo o net/http, preparar ejemplos para gRPC-Gateway o documentación REST, y detectar campos cuyos tags no producen la clave que esperabas.
type Xxx struct { ... }. Se admiten bloques agrupados type ( ... ) y varios structs a la vez.decimal.Decimal) pasan a null.curl -d, en el body de Postman o en un test de handler basado en 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
}El Base embebido aporta id y created_at directamente a Job, y Attempts, con el tag ,string, pasa a ser la cadena "0" en lugar de un número. Token (tag -) y el lastErr no exportado se descartan, mientras que Done, sin tag, conserva su nombre de campo de Go como clave. time.Time muestra el valor cero de Go, 0001-01-01T00:00:00Z.
json:"name" como clave y, si no hay tag, recurre al nombre exacto del campo.json:"-" y los campos en minúscula no exportados; json:"-," conserva el campo bajo la clave literal -.,string, los campos numéricos y booleanos se envuelven como cadenas del tipo "0" y "false".*int, *Profile) se rellenan con el tipo apuntado, y los tipos definidos como type Status string siguen su tipo subyacente.[]byte pasa a una cadena Base64 (vacía), map[int]T usa una clave "0", time.Duration es el entero de nanosegundos 0, e interface{}/any son null.Children []Node se detienen en un array vacío. Se admiten los campos de struct anónimos anidados.Pega el struct que vinculas con c.ShouldBindJSON(&req), genera el body y llama al endpoint mediante httptest.NewRequest o curl. Como las claves salen directamente de los tags, es menos probable que el binding no coincida.
Los tags json:"user_id" y json:"userId" mezclados, o un tag olvidado que deja escapar una clave UserID en mayúsculas, se ven de un vistazo en la salida.
Entrega a los consumidores de frontend o Python el JSON de tu struct de respuesta en Go; pueden volver a convertirlo en modelos con herramientas como JSON → TypeScript o JSON → Python.
omitempty siempre aparecen en el ejemplo; el marshal real los omite cuando contienen el valor cero.nil se serializa como null, pero el ejemplo muestra el caso con valor.MarshalJSON() personalizado y el contenido real de json.RawMessage no se pueden conocer y no se reflejan.omitzero de Go 1.24 ni el comportamiento de encoding/json/v2.encoding/json usa literalmente el nombre del campo exportado, así que Done bool pasa a "Done". Al decodificar en Go las claves se comparan sin distinguir mayúsculas, pero los clientes en otros lenguajes no lo hacen, así que es más seguro poner tags explícitos.
time.Time tiene el año 0001?El time.Time cero de Go es 0001-01-01 00:00:00 UTC, que en RFC 3339 se serializa como 0001-01-01T00:00:00Z. Por eso difiere de las fechas de 1970 de las otras páginas → JSON.
json:",string"?Sobre todo para IDs int64 grandes que JavaScript no puede representar con exactitud, de modo que viajen como cadenas. El ejemplo muestra "0", lo que deja claro a los clientes que recibirán una cadena.
Usa la página JSON → Go struct. Volver a pasar su salida por esta página es una forma rápida de comprobar que el viaje de ida y vuelta conserva las claves originales.