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.
type Xxx struct { ... }. Les blocs groupés type ( ... ) et plusieurs structs à la fois sont acceptés.decimal.Decimal) deviennent null.curl -d, un corps Postman ou un test de handler basé sur 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
}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.
json:"name" comme clé, et à défaut de tag le nom exact du champ.json:"-" et les champs non exportés en minuscules ; json:"-," garde le champ sous la clé littérale -.,string, les champs numériques et booléens sont encapsulés en chaînes comme "0" et "false".*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.Children []Node s'arrêtent à un tableau vide. Les champs de struct anonymes imbriqués sont pris en charge.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.
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.
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.
omitempty figurent toujours dans l'exemple ; le vrai marshaling les supprime quand ils contiennent la valeur zéro.nil est sérialisé en null, mais l'exemple montre le cas renseigné.MarshalJSON() personnalisé et le contenu réel de json.RawMessage ne peuvent pas être connus et ne sont pas reflétés.omitzero de Go 1.24 et le comportement d'encoding/json/v2 ne sont pas couverts.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.
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.
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.
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.