Les méthodes HTTP énoncent votre intention sur une ressource ; les codes de statut sont la réponse codée du serveur. Deux propriétés comptent pour les méthodes : safe (lecture seule, sans effet de bord) et idempotent (la répéter donne le même résultat — important pour des retries sûrs).
| Méthode | But | Safe | Idempotent |
|---|
| GET | Lire une ressource | Oui | Oui |
| POST | Créer / déclencher une action | Non | Non |
| PUT | Remplacer une ressource | Non | Oui |
| PATCH | Mettre à jour partiellement | Non | Non* |
| DELETE | Supprimer une ressource | Non | Oui |
| HEAD | Comme GET, headers seuls | Oui | Oui |
La distinction d'idempotence est pratique : parce que PUT et DELETE sont idempotents, un client peut les retenter en toute sécurité après un timeout ; retenter un POST non idempotent risque de créer un doublon (un classique bug de double débit).
Les codes de statut sont regroupés par leur premier chiffre :
1xx Informational request received, continuing (100 Continue, 101 Switching)
2xx Success it worked (200 OK, 201 Created, 204 No Content)
3xx Redirection go elsewhere (301 Moved, 304 Not Modified)
4xx Client error YOUR request is wrong (400, 401, 403, 404, 429)
5xx Server error the SERVER failed (500, 502, 503, 504)
La ligne la plus importante est la séparation 4xx vs 5xx : 4xx signifie que le client a envoyé quelque chose d'incorrect (mauvaise entrée, non authentifié, non trouvé) — retenter à l'identique ne servira à rien ; 5xx signifie que le serveur a échoué — retenter (avec backoff) pourrait réussir. Connaissez sur le bout des doigts les plus courants : 401 (non authentifié) vs 403 (authentifié mais non autorisé), 404 (non trouvé), 429 (rate limité), 500 (crash serveur générique), 502/503/504 (bad gateway / indisponible / gateway timeout — généralement un problème en amont ou de surcharge).
Ces codes sont le contrat partagé entre chaque client et serveur, donc une aisance ici est attendue de quiconque construit ou consomme des API. Les recruteurs sondent les distinctions qui révèlent une vraie compréhension : 401 vs 403, PUT vs PATCH, et surtout l'idempotence, qui gouverne directement si les retries sont sûrs — une préoccupation centrale dans les systèmes distribués et les flux de paiement. Renvoyer le bon code de statut rend aussi votre API prévisible et correctement gérée par les caches, proxies et bibliothèques clientes, donc cette connaissance façonne une bonne conception d'API, et pas seulement une trivialité.
Une bibliothèque de questions d'entretien IT avec des réponses détaillées — du Junior au Senior.
Faire un don