0Pricing
Go Academy · Leçon

Assistants de réponse et codes d’état

c.JSON, c.AbortWithError et réponses d’erreur

Assistants de réponse et codes d’état 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.

c.JSON

c.JSON(statusCode, obj) sérialise obj en JSON et définit Content-Type sur application/json. Il s’agit de la méthode de réponse la plus courante.

c.JSON(http.StatusOK, gin.H{
    "id":   user.ID,
    "name": user.Name,
})

gin.H

gin.H est un raccourci pour map[string]any. Utilisez-le pour créer des objets JSON ponctuels sans définir de structure.

c.JSON(200, gin.H{"message": "created", "id": id})

Constantes des codes d’état HTTP

Utilisez les constantes http.Status* plutôt que des nombres bruts pour améliorer la clarté :

c.JSON(http.StatusCreated, gin.H{"id": id})
c.JSON(http.StatusBadRequest, gin.H{"error": "invalid input"})
c.JSON(http.StatusInternalServerError, gin.H{"error": "internal error"})

c.String et c.Data

Envoyez du texte brut avec c.String ou des octets quelconques avec c.Data :

c.String(200, "Hello, %s!", name)
c.Data(200, "application/octet-stream", fileBytes)

c.File et c.FileAttachment

Servez un fichier depuis le disque, directement dans la réponse ou sous forme de téléchargement :

c.File("./public/report.pdf")           // inline
c.FileAttachment("./report.pdf", "report.pdf") // download

c.Redirect

Envoyez une redirection HTTP (301 permanente, 302 temporaire) :

c.Redirect(http.StatusMovedPermanently, "/new-url")

c.AbortWithStatus

Arrêtez le traitement de la chaîne de requête et écrivez une réponse vide avec le code d’état indiqué. Contrairement à c.JSON, cette fonction appelle Abort pour empêcher l’exécution des gestionnaires suivants.

c.AbortWithStatus(http.StatusUnauthorized)

c.Error

Ajoutez des erreurs au contexte sans écrire de réponse. Un intergiciel peut les collecter et écrire une réponse d’erreur unifiée à la fin.

c.Error(fmt.Errorf("database error: %w", err))

En-têtes de réponse

Définissez des en-têtes de réponse personnalisés avant d’appeler c.JSON ou c.Data :

c.Header("X-Request-ID", requestID)
c.Header("Cache-Control", "max-age=3600")

Génération de XML

Gin prend également en charge les réponses XML et YAML :

c.XML(200, user) // requires xml struct tags
c.YAML(200, user)

Structure de réponse personnalisée

Définissez une enveloppe de réponse d’API standard afin d’obtenir une structure cohérente pour tous les points d’accès :

type APIResponse struct {
    Success bool   `json:"success"`
    Data    any    `json:"data,omitempty"`
    Error   string `json:"error,omitempty"`
}

Vérification rapide

Que fait c.AbortWithStatus de différent par rapport à c.Status ?

Récapitulatif : assistants de réponse

Points clés :

  • c.JSON(statusCode, obj) est la principale méthode de réponse JSON
  • Utilisez les constantes http.Status* pour améliorer la clarté
  • c.AbortWithStatus arrête la chaîne des gestionnaires
  • Définissez une enveloppe APIResponse cohérente pour tous les points d’accès

Questions Fréquemment Posées

La leçon « Assistants de réponse et codes d’état » est-elle gratuite ?

Oui — le texte complet de « Assistants de réponse et codes d’état » 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 « Assistants de réponse et codes d’état » ?

c.JSON, c.AbortWithError et réponses d’erreur 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 « Assistants de réponse et codes d’état » ?

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. Routeur Gin et groupes de routes
  2. Association et validation des requêtes
  3. Assistants de réponse et codes d’état
  4. Intergiciel Gin : authentification et journalisation
← Retour à Go Academy