Retour au blog Guide Pratique - 8 min

Comment analyser le code HTTP retourné par une URL

Lisez le code HTTP réel d’une URL avec curl -I : 200, 301, 404 ou 500, en suivant ou non les redirections, en-têtes compris.

Analyser le code HTTP d’une URL, c’est lire la première ligne de statut renvoyée par le serveur, avant que le navigateur ne suive une redirection ou n’affiche un message à lui. La commande de base est curl -sI sur l’URL exacte. Le code classe la réponse : succès, redirection, erreur client, erreur serveur. Il ne dit pas, à lui seul, si le HTML est le bon.

Lire la ligne de statut

curl -sI https://exemple.fr/page

-s tait la barre de progression, -I ne demande que les en-têtes (méthode HEAD). Vous obtenez HTTP/2 200, ou 301, 404, 500, plus les en-têtes. Si HEAD est refusé (certains serveurs répondent 405), refaites sans -I et coupez le corps : curl -s -o NUL -D - https://exemple.fr/page sous Windows, ou -o /dev/null sous un shell Unix. Le statut est dans les en-têtes, pas dans le HTML.

Sans -L, curl s’arrête au premier saut. C’est ce que vous voulez pour voir un 301. Avec -L, il enchaîne et le dernier statut est celui de la page finale. Les deux lectures sont utiles : la première pour la redirection, la seconde pour la cible.

Un test d’URL fait la même lecture depuis l’extérieur et conserve le code, l’en-tête et le temps. Pratique quand vous n’avez pas curl sous la main ou quand il faut comparer plus tard.

À quoi correspond la classe

CodeLecture pratiqueSuite
200Le serveur a renvoyé un corpsVérifier que le HTML est la bonne page
204Succès sans corpsRare sur une page HTML
301Redirection définitiveRegarder l’en-tête Location
302 ou 307Redirection temporaireÀ justifier : maintenance courte, pas une URL renommée
308Redirection définitive qui conserve la méthodeMême usage qu’un 301 pour un navigateur
401 / 403Authentification ou interditAttendu sur un admin, anormal sur une page publique
404IntrouvablePage supprimée ou lien faux
410Parti pour de bonPlus clair qu’un 404 pour une URL retirée
429Trop de requêtesPlafond atteint, réessayer plus tard
500Erreur applicativeLogs du serveur
502 / 504Passerelle ou délaiOrigine morte, PHP trop lent, proxy
503Indisponible, souvent vouluMaintenance : acceptable avec Retry-After

Le découpage 4xx / 5xx et l’effet sur l’exploration sont développés dans Différence entre erreurs 4xx et 5xx. Les en-têtes qui accompagnent le code (cache, robots, HSTS) se lisent dans la même réponse : Surveiller les en-têtes HTTP.

Pièges de lecture

Le 200 menteur. Une maintenance servie en 200, une recherche interne vide servie en 200, une erreur « page cassée » habillée comme le site : le statut est vert, le contenu non. Cherchez une chaîne attendue (curl -s https://exemple.fr/ | findstr /C:"Titre de la page" sous Windows). Absence de la chaîne : la page n’est pas la bonne, quel que soit le 200.

La chaîne de redirections. Notez chaque Location. Trois sauts pour aller de http://www à https:// apex ralentissent et diluent le signal. La cible finale doit être un 200, pas un nouveau 301, pas une 404.

Le nom et le certificat. Si curl s’arrête avant le HTTP avec une erreur TLS, vous n’avez pas de code HTTP. Corrigez le certificat ou le nom, puis relisez le statut.

Le cache. Un 200 peut venir d’un CDN. Relancez avec un contournement de cache si le fournisseur le prévoit, ou comparez à l’origine, avant de conclure que le correctif est en ligne.

HEAD incomplet. Certaines stacks ne calculent pas le même statut en HEAD et en GET (redirection seulement en GET). En cas de doute, refaites la requête GET et lisez la première ligne de statut.

Gardez l’URL exacte dans la note : schéma, hôte, slash final, paramètres. http://exemple.fr et https://www.exemple.fr/ sont quatre contrôles différents tant que les redirections ne sont pas prouvées. Le code utile pour une recette est celui de l’URL publique finale, plus celui de l’ancienne URL si vous vérifiez une 301.


Premier statut sans suivre, puis statut final avec -L, puis une chaîne du HTML. Les trois lectures évitent de prendre un 301 ou un 200 vide pour un succès.

Questions fréquentes

Comment voir le code HTTP sans ouvrir le navigateur ?

curl -sI https://exemple.fr/affiche les en-têtes et la ligne de statut. Ajoutez -L pour suivre les redirections, ou omettez-le pour voir le premier code, souvent un 301.

Un code 200 prouve-t-il que la page est la bonne ?

Non. Un 200 peut servir une page de connexion, une erreur « soft 404 », ou un HTML de maintenance. Il faut le code et un extrait du contenu attendu.

Pourquoi le navigateur et curl ne montrent-ils pas le même code ?

Le navigateur suit les redirections et peut afficher la page finale en 200 alors que la première réponse était un 301 ou un 302. curl sans -L montre cette première réponse.

Surveiller mes URL