Définir les codes d’état des réponses JSON
Associez les contenus JSON aux codes 201, 404 et autres.
Définir les codes d’état des réponses JSON est une leçon Flask 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 Flask Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Flask Academy comprend 4 leçons au total.
Les codes d'état racontent l'histoire
Toute réponse HTTP contient un code d'état qui signale la réussite ou l'échec. Votre corps JSON explique les détails, mais le code donne d'abord le ton. 🚦
La valeur par défaut est 200
Lorsque vous renvoyez uniquement jsonify, Flask envoie 200 OK. C'est parfait pour une lecture réussie, mais d'autres actions méritent leur propre code.
Renvoyez un tuple
Pour choisir un code, renvoyez un tuple composé de la réponse JSON et du nombre. Flask interprète le deuxième élément comme le code d'état HTTP à envoyer.
return jsonify(message="created"), 201201 pour une création
Lorsqu'une requête crée un nouvel enregistrement, répondez avec 201 Created. Cela indique au client que la ressource existe désormais, ce que 200 seul ne permettrait pas de comprendre.
return jsonify(id=new_id), 201404 pour une ressource introuvable
Si l'élément demandé n'existe pas, renvoyez un corps JSON avec 404. Le client comprend que la ressource est absente, et non que le serveur est en panne.
return jsonify(error="user not found"), 404400 pour une entrée incorrecte
Lorsqu'un client envoie des données non valides, répondez avec 400 Bad Request. Accompagnez ce code d'un message JSON qui explique précisément le problème.
return jsonify(error="name is required"), 400La famille des 2xx
Les codes de la plage 2xx indiquent une réussite. 200 correspond à une lecture, 201 à une création et 204 signale une réussite sans corps à renvoyer.
La famille des 4xx
Les codes de la plage 4xx mettent la responsabilité sur le client. 400 signifie entrée incorrecte, 401 signifie non authentifié et 403 signifie accès interdit.
La famille des 5xx
Les codes de la plage 5xx mettent la responsabilité sur le serveur. Un 500 signifie que votre code a déclenché une erreur non gérée lors du traitement d'une requête pourtant valide.
Ajoutez aussi des en-têtes
Vous pouvez étendre le tuple à trois éléments : le corps, le code d'état et un dictionnaire d'en-têtes. Vous pouvez ainsi joindre des métadonnées supplémentaires dans un seul retour clair.
return jsonify(ok=True), 201, {"X-Created": "now"}La cohérence inspire confiance
Choisissez le bon code pour chaque résultat et utilisez-le partout. Des codes d'état cohérents rendent votre API prévisible et agréable à intégrer.
Vérification rapide
Associez chaque action au code d'état HTTP le plus approprié.
Récapitulatif
Vous avez appris à associer les corps JSON au bon code d'état en renvoyant un tuple, et à utiliser 201, 404 et 400 pour rendre votre API claire et honnête. ✅
Questions Fréquemment Posées
La leçon « Définir les codes d’état des réponses JSON » est-elle gratuite ?
Oui — le texte complet de « Définir les codes d’état des 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 Flask Academy, passe à CoddyKit PRO. Le cours Flask Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Définir les codes d’état des réponses JSON » ?
Associez les contenus JSON aux codes 201, 404 et autres. Tu pratiques Flask 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 Flask Academy ?
Aucune expérience préalable n'est requise. Flask 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éfinir les codes d’état des 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 Flask Academy ?
Oui. Chaque leçon Flask 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
- Convertir un dictionnaire en JSON avec jsonify
- Renvoyer des listes et des données imbriquées
- Définir les codes d’état des réponses JSON
- Content-Type et l’en-tête Accept