Convertissez des structs Go en JSON !

Saisissez des structs Go pour générer un JSON d'exemple selon leurs balises json ! Compatible avec Go (Golang) struct, json tags. Pratique pour documenter une API et créer des corps de requête de test (mock request body).
Go struct
Résultat
 

Convertissez des structs Go en JSON !

Collez des définitions de struct Go et obtenez un document JSON d'exemple construit avec les mêmes règles que encoding/json lors du marshaling : noms des tags json:"...", champs masqués avec -, option ,string, champs non exportés en minuscules et structs embarquées aplaties.

Pratique pour produire un corps curl à partir d'une struct de requête Gin, Echo ou net/http, préparer des exemples pour gRPC-Gateway ou une doc REST, et repérer les champs dont les tags ne donnent pas la clé attendue.

Mode d'emploi

  1. Collez des déclarations type Xxx struct { ... }. Les blocs groupés type ( ... ) et plusieurs structs à la fois sont acceptés.
  2. Si un champ utilise une autre struct, incluez aussi sa définition. Les types de paquets externes absents de l'entrée (comme decimal.Decimal) deviennent null.
  3. Il n'y a pas d'options : la première struct qu'aucun autre type ne référence devient le JSON de premier niveau ; placez donc celle que vous voulez en premier ou retirez les structs sans rapport.
  4. Copiez le résultat dans curl -d, un corps Postman ou un test de handler basé sur httptest.

Exemple

Entrée (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
}
Sortie (JSON)
{
  "id": "",
  "created_at": "0001-01-01T00:00:00Z",
  "queue": "",
  "attempts": "0",
  "labels": {
    "key": ""
  },
  "timeout_sec": 0,
  "Done": false
}

La struct embarquée Base apporte directement id et created_at à Job, et Attempts, tagué avec ,string, devient la chaîne "0" au lieu d'un nombre. Token (tag -) et le champ non exporté lastErr sont supprimés, tandis que Done, sans tag, garde son nom de champ Go comme clé. time.Time affiche la valeur zéro de Go, 0001-01-01T00:00:00Z.

Fonctionnalités prises en charge

  • Utilise le tag json:"name" comme clé, et à défaut de tag le nom exact du champ.
  • Ignore les champs json:"-" et les champs non exportés en minuscules ; json:"-," garde le champ sous la clé littérale -.
  • Avec ,string, les champs numériques et booléens sont encapsulés en chaînes comme "0" et "false".
  • Les structs embarquées sans tag sont aplaties dans le parent, les champs extérieurs l'emportant en cas de conflit de noms ; une struct embarquée taguée devient un objet imbriqué sous ce nom.
  • Les pointeurs (*int, *Profile) sont remplis avec le type pointé, et les types définis comme type Status string suivent leur type sous-jacent.
  • []byte devient une chaîne Base64 (vide), map[int]T utilise une clé "0", time.Duration est l'entier en nanosecondes 0, et interface{}/any valent null.
  • Les structs autoréférentes comme Children []Node s'arrêtent à un tableau vide. Les champs de struct anonymes imbriqués sont pris en charge.

Cas d'utilisation

Corps de requête pour les tests de handlers

Collez la struct que vous liez avec c.ShouldBindJSON(&req), générez le corps et appelez l'endpoint via httptest.NewRequest ou curl. Comme les clés viennent directement des tags, les erreurs de binding sont moins probables.

Repérer les erreurs de tags

Des tags json:"user_id" et json:"userId" mélangés, ou un tag oublié qui laisse fuiter une clé UserID en majuscules, sautent aux yeux dans la sortie.

Partager un schéma avec des clients dans d'autres langages

Donnez aux consommateurs frontend ou Python le JSON de votre struct de réponse Go ; ils peuvent le retransformer en modèles avec des outils comme JSON → TypeScript ou JSON → Python.

Remarques et limites

  • Les champs omitempty figurent toujours dans l'exemple ; le vrai marshaling les supprime quand ils contiennent la valeur zéro.
  • Un pointeur nil est sérialisé en null, mais l'exemple montre le cas renseigné.
  • Les types dotés d'un MarshalJSON() personnalisé et le contenu réel de json.RawMessage ne peuvent pas être connus et ne sont pas reflétés.
  • Les options plus récentes comme omitzero de Go 1.24 et le comportement d'encoding/json/v2 ne sont pas couverts.

FAQ

Quelle clé reçoit un champ sans tag ?

encoding/json utilise tel quel le nom du champ exporté : Done bool devient donc "Done". Le décodage en Go compare sans tenir compte de la casse, mais pas les clients dans d'autres langages : des tags explicites sont plus sûrs.

Pourquoi time.Time vaut-il l'an 0001 ?

La valeur zéro de time.Time en Go est 0001-01-01 00:00:00 UTC, sérialisée en RFC 3339 sous la forme 0001-01-01T00:00:00Z. C'est pourquoi elle diffère des dates de 1970 des autres pages → JSON.

À quoi sert json:",string" ?

Surtout aux grands identifiants int64 que JavaScript ne peut pas représenter exactement, pour qu'ils transitent en chaînes. L'exemple affiche "0", ce qui indique clairement aux clients qu'ils recevront une chaîne.

Je veux l'inverse : des structs Go à partir de JSON.

Utilisez la page JSON → Go struct. Réinjecter sa sortie dans cette page est un moyen rapide de vérifier que l'aller-retour conserve les clés d'origine.