code de statut
Un code de statut est le nombre à trois chiffres par lequel une réponse commence, et qui dit comment l'appel s'est passé avant même qu'on lise autre chose.
En détail
Le premier chiffre dit tout. Deux cents et quelques veut dire que cela a marché. Trois cents et quelques veut dire de chercher ailleurs. Quatre cents et quelques veut dire que l'appel lui-même est à changer, et cinq cents et quelques que la machine qui répond a quelque chose à corriger.
Le reste du nombre précise, et la réponse dit d'ordinaire en mots ce que le nombre dit en chiffres. Un programme lit le nombre ; une personne lit la phrase.
Ce qu'il fait sur un vrai document
Une requête qui a réussi répond deux cents, et le corps de cette réponse est le PDF. Tout le reste répond par une phrase nommant ce qui l'a arrêtée, qui vaut d'être écrite mot pour mot dans votre propre journal.
Quatre cents veut dire que la description a demandé quelque chose que le moteur n'a pas pu employer, quatre cent deux que la demande porte sur quelque chose que couvre une clé de licence et que le compte n'en a pas, et quatre cent treize que le corps de l'appel a dépassé la taille que le service accepte, ou que le document a dépassé le nombre de pages qu'il autorise.
D'où il vient, et pourquoi
Les nombres ont été choisis quand la première version du protocole a été écrite, et les grouper par leur premier chiffre était tout l'objet : un programme qui n'a jamais rencontré un nombre donné sait tout de même s'il doit réessayer, chercher ailleurs ou renoncer.
Quelques-uns sont passés dans le langage courant — celui d'une page qui n'existe pas s'imprime sur des tee-shirts — ce qui en dit long sur la durée de vie d'une bonne convention.