¡Convierte structs de Go en JSON!

¡Introduce structs de Go para generar un JSON de ejemplo según sus etiquetas json! Compatible con Go (Golang) struct, json tags. Útil para documentar APIs y cuerpos de petición de prueba (mock request body).
Go struct
Resultado
 

¡Convierte structs de Go en JSON!

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.

Cómo usar

  1. Pega declaraciones type Xxx struct { ... }. Se admiten bloques agrupados type ( ... ) y varios structs a la vez.
  2. Si un campo usa otro struct, incluye también esa definición. Los tipos de paquetes externos que no están en la entrada (como decimal.Decimal) pasan a null.
  3. No hay opciones: el primer struct que ningún otro tipo referencia es el JSON de nivel superior, así que pon primero el que quieras o deja fuera los structs no relacionados.
  4. Copia el resultado en curl -d, en el body de Postman o en un test de handler basado en httptest.

Ejemplo

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

Funciones compatibles

  • Usa el tag json:"name" como clave y, si no hay tag, recurre al nombre exacto del campo.
  • Omite los campos json:"-" y los campos en minúscula no exportados; json:"-," conserva el campo bajo la clave literal -.
  • Con ,string, los campos numéricos y booleanos se envuelven como cadenas del tipo "0" y "false".
  • Los structs embebidos sin tag se aplanan en el padre, y los campos exteriores ganan si los nombres chocan; un struct embebido con tag pasa a ser un objeto anidado con ese nombre.
  • Los punteros (*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.
  • Los structs autorreferenciados como Children []Node se detienen en un array vacío. Se admiten los campos de struct anónimos anidados.

Casos de uso

Bodies de petición para tests de handlers

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.

Encontrar errores en los tags

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.

Compartir un schema con clientes en otros lenguajes

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.

Notas y limitaciones

  • Los campos omitempty siempre aparecen en el ejemplo; el marshal real los omite cuando contienen el valor cero.
  • Un puntero nil se serializa como null, pero el ejemplo muestra el caso con valor.
  • Los tipos con un MarshalJSON() personalizado y el contenido real de json.RawMessage no se pueden conocer y no se reflejan.
  • No se cubren opciones más nuevas como el omitzero de Go 1.24 ni el comportamiento de encoding/json/v2.

Preguntas frecuentes

¿Qué clave recibe un campo sin tag?

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.

¿Por qué 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.

¿Cuándo es útil 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.

Quiero lo contrario: structs de Go a partir de JSON.

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.