¡Convierte JSON en structs de Go!

¡Introduce JSON para convertirlo en structs de Go con etiquetas json! Compatible con Go (Golang) struct, json tags.
JSON
Resultado

¡Convierte JSON en structs de Go!

Convierte JSON en definiciones de struct de Go con tags de encoding/json. Los nombres de campo siguen la regla de nombres exportados de Go y la lista de siglas de golint (ID, URL, API, ...), y las columnas quedan alineadas como si el código hubiera pasado por gofmt.

Es útil cuando necesitas un tipo en el que hacer json.Unmarshal de un payload de webhook o una respuesta de API, un struct para el body de las peticiones en handlers de net/http, Gin o Echo, o un struct de configuración para un CLI.

Cómo usar

  1. Pega el JSON. Con un array de varias filas, se detectan los campos que faltan en algunas filas y se marcan con omitempty.
  2. Escribe el nombre del struct de nivel superior en Nombre del struct (por defecto Root); se queda en la URL como ?name=.
  3. Pega el resultado en un archivo .go y añade una cláusula package. Si se encontraron campos de tiempo, se incluye import "time".
  4. Úsalo como var ev WebhookEvent; err := json.Unmarshal(body, &ev).

Ejemplo

Entrada (JSON)
{
  "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
}
Salida (Go)
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 pasa a EventID según la regla de siglas de golint, y created_at, una cadena RFC 3339, se infiere como time.Time, lo que añade import "time". retry_count es null, así que su tipo es desconocido: pasa a any con omitempty.

Funciones compatibles

  • Un tag json:"originalKey" en cada campo, más ,omitempty en los campos que faltan en algunas filas o contienen null.
  • Los tipos de valor opcionales (int, string, bool, structs, time.Time) pasan a punteros (*int) para que "ausente" se distinga del valor cero. Los slices y any ya admiten nil y no se convierten en punteros.
  • Números: int para enteros de 32 bits, int64 por encima de eso, float64 cuando aparecen decimales.
  • Las cadenas RFC 3339 como 2024-05-01T03:15:00Z se infieren como time.Time.
  • Las siglas habituales se quedan en mayúsculas (user_id → UserID, home_url → HomeURL); las claves que empiezan por un dígito reciben el prefijo Field.
  • Las claves que no pueden aparecer en un tag json de Go, como "", se omiten y se listan en un comentario encima del struct.
  • Un array de objetos de nivel superior se convierte en un struct para el elemento más un comentario para hacer unmarshal en []Root.

Casos de uso

Receptores de webhooks

Construye un struct a partir de un evento de ejemplo enviado por un servicio de pagos o de hosting de Git y decodifícalo con json.NewDecoder(r.Body).Decode(&ev), en lugar de encadenar type assertions sobre map[string]any.

Binding de peticiones en Gin o Echo

Genera el struct para c.ShouldBindJSON(&req) a partir de una petición de ejemplo del cliente y luego añade tags binding:"required" donde haga falta.

CLIs que leen configuración JSON

Convierte config.json en un struct una vez, y un solo json.Unmarshal después de os.ReadFile te da toda la configuración como valores tipados.

Notas y limitaciones

  • time.Time solo se infiere para cadenas RFC 3339; valores como 2024-05-01 03:15:00 o timestamps Unix se quedan como string o int.
  • json.Unmarshal ignora las claves desconocidas y por defecto compara las claves sin distinguir mayúsculas. Usa Decoder.DisallowUnknownFields() si quieres una decodificación estricta.
  • int es de 64 bits en plataformas de 64 bits, pero int64 solo se escribe cuando un valor de ejemplo supera los 32 bits. Para IDs que pueden crecer, es más seguro cambiar tú mismo a int64.
  • Todos los structs anidados se definen como tipos de nivel superior separados; no se usan structs anónimos en línea.
  • Los valores de tipo mixto y los que solo valen null pasan a any; sustitúyelos cuando conozcas el tipo real.

Preguntas frecuentes

¿Por qué los campos opcionales son punteros como *int?

Un campo int simple vale 0 cuando falta la clave, indistinguible de un 0 real. Un puntero es nil cuando la clave está ausente o es null, y junto con omitempty la clave se omite al volver a hacer marshal.

¿Puedo poner los nombres de campo en minúscula?

encoding/json solo lee y escribe campos exportados (con mayúscula inicial); los campos en minúscula se ignoran aunque tengan tag. En Go, los nombres se quedan con mayúscula y la clave JSON va en el tag.

Un campo null como retry_count salió como any.

Con solo null en el ejemplo no hay nada de lo que inferir un tipo. Añade a un array otra respuesta con un valor real y convierte ambas, o cámbialo a mano a algo como *int.

¿Puedo convertir un struct de Go de vuelta en JSON de ejemplo?

Sí. Pega el struct en la pestaña Go struct → JSON de arriba; lee los tags y produce JSON de ejemplo.