Liste des codes de statut HTTP par catégorie
Sélectionnez une catégorie de réponses HTTP et obtenez la liste complète et ordonnée de ses codes de statut standard attribués, avec leurs libellés.
Lancer gratuitement
Les cinq catégories acceptées sont les réponses informatives, les succès, les redirections, les erreurs client et les erreurs serveur, soit les classes 1xx à 5xx. Le résultat précise aussi la plage numérique et le nombre d’entrées. Il convient donc à la documentation, aux tests, aux outils de développement et à la consultation rapide du protocole, sans requête réseau ni examen d’un serveur actif.
Choisissez l’une des cinq classes de réponse HTTP
Les codes de statut HTTP sont regroupés selon leur premier chiffre. Les réponses informatives occupent la plage 100–199 et décrivent une progression provisoire avant la réponse finale. Les succès utilisent 200–299 et signalent qu’une requête a été reçue, comprise ou achevée selon le sens du code concerné. Les redirections emploient 300–399 pour la sélection de ressources, les changements d’emplacement, la validation du cache et les décisions d’acheminement associées. Les erreurs client utilisent 400–499 lorsqu’une requête ne peut pas aboutir en raison de sa syntaxe, de ses identifiants, de ses préconditions, de sa cible, de sa fréquence ou d’une autre condition côté client. Les erreurs serveur emploient 500–599 lorsqu’un serveur ou un intermédiaire ne peut pas terminer une requête apparemment valide. Indiquez une catégorie : le résultat fournit son nom canonique, sa plage numérique, son nombre d’entrées et un tableau `statuses` croissant. La comparaison ignore la casse, les espaces périphériques, les traits d’union et les tirets bas. Tout autre libellé est explicitement refusé au lieu d’être interprété au hasard.
Interprétez précisément les codes et leurs libellés
Chaque entrée du tableau contient un `code` numérique et sa `reason_phrase` normalisée. Ce libellé est une désignation conventionnelle concise, et non une explication exhaustive des circonstances où la réponse doit être produite. Ainsi, 404 Not Found désigne le résultat, tandis que la spécification HTTP applicable définit le comportement du cache, les interactions avec les méthodes et la sémantique de la représentation. La terminologie moderne du registre est retenue lorsque d’anciennes références diffèrent : 413 correspond à Content Too Large et 422 à Unprocessable Content. Le code 418 figure avec le libellé de registre Unused ; la célèbre allusion à la théière vient d’une ancienne spécification expérimentale et ne constitue pas son intitulé actuel dans le registre principal. Les valeurs non attribuées sont volontairement absentes. Une catégorie ne contient donc pas forcément chaque entier de sa plage. La liste est triée numériquement afin que vous puissiez directement afficher un tableau, comparer les codes autorisés ou créer un sélecteur. Les libellés sont des métadonnées : HTTP/2 et HTTP/3 ne transmettent aucun champ de ce type, et la logique cliente doit utiliser le code numérique.
Exploitez le résultat pour documenter et valider
Cette capacité convient lorsqu’un outil a besoin d’un référentiel délimité plutôt que d’informations sur une réponse réelle. Un générateur de documentation peut demander chaque catégorie et produire des tableaux cohérents. Une suite de tests peut vérifier qu’une application renvoie un code enregistré dans la classe prévue, tout en appliquant ses propres règles sur les réponses admises par chaque endpoint. Un explorateur d’API peut remplir un menu groupé avec les libellés obtenus, et un support pédagogique peut comparer les réponses provisoires, réussies, redirigées, en erreur client ou en erreur serveur. Le calcul repose sur une table fixe en mémoire : aucune requête réseau, aucune lecture d’état serveur, aucun stockage de l’entrée, et un résultat identique pour une même catégorie normalisée. Il ne décide pas si un code convient à un cas métier, n’ajoute pas les codes propres aux fournisseurs et n’interprète pas le corps d’une réponse. Les registres pouvant évoluer, les utilisateurs qui exigent une référence juridiquement ou opérationnellement officielle doivent aussi conserver la version de spécification adoptée par leur projet. Le navigateur et l’API partagent ce solveur déterministe ; un appel API coûte $0.002.
Cas d’usage
Créer des tableaux de documentation API
Générez un tableau de référence ordonné pour une classe de réponse, avec des codes numériques et des libellés cohérents.
Valider les politiques de réponse
Comparez les réponses autorisées par une application aux codes attribués dans la catégorie HTTP attendue.
Alimenter les outils de développement
Remplissez des sélecteurs groupés, des aide-mémoire et des interfaces pédagogiques à partir d’un résultat structuré et déterministe.
Questions fréquentes
Quels noms de catégorie sont acceptés ?
Utilisez informational, success, redirect, client error ou server error. La casse est ignorée, et les noms composés acceptent aussi les traits d’union ou les tirets bas.
La liste contient-elle tous les nombres de la plage ?
Non. Elle contient les codes standard attribués et omet les valeurs non attribuées des plages 1xx, 2xx, 3xx, 4xx ou 5xx.
Pourquoi le statut 418 porte-t-il le libellé Unused ?
Le registre HTTP principal actuel réserve 418 avec le libellé Unused. La célèbre référence à une théière provient d’une spécification expérimentale.
Cet outil peut-il contrôler une URL active ?
Non. Il s’agit d’une consultation déterministe sans requête réseau. Utilisez une capacité d’inspection HTTP pour examiner un endpoint actif.
Toutes les versions HTTP transmettent-elles un libellé ?
Non. Ces expressions sont conventionnelles, et HTTP/2 comme HTTP/3 ne transmettent aucun champ de libellé. Votre logique doit utiliser le code numérique.
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/dev2/http-status-by-category \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"category":"client error"}'const res = await fetch("https://api.kit.forhosting.com/dev2/http-status-by-category", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"category": "client error"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev2/http-status-by-category",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"category": "client error"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev2/http-status-by-category", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"category":"client error"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"category":"client error"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev2/http-status-by-category", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"category": "client error"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev2.http_status_by_category",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |