0Pricing
Go Academy · Leçon

Décoder les réponses JSON

Analyser les réponses d’API en structs Go

Décoder les réponses JSON est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 3 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Go Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Go Academy comprend 4 leçons au total.

Vérifier le code d’état avant le décodage

Vérifiez toujours que le code d’état de la réponse est de la série 2xx avant d’essayer de décoder le corps. Les réponses qui ne sont pas de la série 2xx peuvent contenir des pages d’erreur HTML, et non du JSON.

if resp.StatusCode < 200 || resp.StatusCode >= 300 {
    body, _ := io.ReadAll(resp.Body)
    return fmt.Errorf("status %d: %s", resp.StatusCode, body)
}

json.NewDecoder

Décodez la réponse en flux sans la charger entièrement en mémoire :

var result APIResponse
if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
    return fmt.Errorf("decode: %w", err)
}

Décodage dans une map générique

Pour les structures JSON inconnues ou dynamiques, décodez dans map[string]any :

var m map[string]any
json.NewDecoder(resp.Body).Decode(&m)

Structures imbriquées

Modélisez le JSON imbriqué à l’aide de structures Go imbriquées et de balises json :

type Repo struct {
    Name  string `json:"name"`
    Owner struct {
        Login string `json:"login"`
    } `json:"owner"`
}

Champs facultatifs avec des pointeurs

Utilisez des types pointeurs pour les champs JSON facultatifs afin de distinguer « champ absent » de « champ défini sur la valeur zéro » :

type Response struct {
    Data  *string `json:"data"`
    Error *string `json:"error"`
}

Décodage de tableaux

Décodez directement les tableaux JSON dans des tranches Go :

var users []User
json.NewDecoder(resp.Body).Decode(&users)

Vérifier les erreurs de décodage

Faites la distinction entre les erreurs de syntaxe JSON et les erreurs de fin de fichier inattendue : EOF signifie que le corps est vide (il ne contient aucun JSON).

err := json.NewDecoder(resp.Body).Decode(&v)
if errors.Is(err, io.EOF) {
    return fmt.Errorf("empty response body")
}

Vérification du type de contenu

Vérifiez que le Content-Type de la réponse est application/json avant le décodage, afin d’éviter d’analyser silencieusement du HTML comme du JSON.

ct := resp.Header.Get("Content-Type")
if !strings.HasPrefix(ct, "application/json") {
    return fmt.Errorf("unexpected content-type: %s", ct)
}

Ignorer les champs inconnus

json.Decoder ignore silencieusement les champs JSON qui ne correspondent à aucun champ de la structure. Il s’agit du comportement par défaut, généralement souhaitable pour assurer la compatibilité future.

Décodage strict avec DisallowUnknownFields

Appelez dec.DisallowUnknownFields() pour renvoyer une erreur en présence de clés inconnues : cette option est utile pour analyser strictement une configuration, mais pas pour consommer les API de fournisseurs tiers.

dec := json.NewDecoder(r.Body)
dec.DisallowUnknownFields()
dec.Decode(&cfg)

Réutiliser la structure décodée

Réinitialisez la structure à zéro avant le décodage si vous la réutilisez pour plusieurs réponses, afin d’éviter de conserver des données obsolètes d’un décodage précédent.

var result APIResult
result = APIResult{} // reset
json.NewDecoder(resp.Body).Decode(&result)

Vérification rapide

Quelle erreur json.Decoder.Decode renvoie-t-il lorsque le corps de la réponse est vide ?

Récapitulatif&nbsp;: décodage des réponses JSON

Points clés :

  • Vérifier le code d’état avant le décodage
  • json.NewDecoder pour le traitement en flux, afin d’éviter de charger tout le corps en mémoire
  • Vérifier que Content-Type est application/json
  • io.EOF signifie que le corps est vide ; io.ErrUnexpectedEOF signifie que le JSON est tronqué

Questions Fréquemment Posées

La leçon « Décoder les réponses JSON » est-elle gratuite ?

Oui — le texte complet de « Décoder les réponses JSON » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Go Academy, passe à CoddyKit PRO. Le cours Go Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Décoder les réponses JSON » ?

Analyser les réponses d’API en structs Go Tu pratiques Go Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Go Academy ?

Aucune expérience préalable n'est requise. Go Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 3 sur 4.

Combien de temps prend la leçon « Décoder les réponses JSON » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Go Academy ?

Oui. Chaque leçon Go Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Effectuer des requêtes HTTP
  2. Configurer les délais d’expiration et les en-têtes
  3. Décoder les réponses JSON
  4. Gestion des erreurs et logique de nouvelle tentative
← Retour à Go Academy