Codes d'état HTTP

De nombreuses cartes d'action dans Workflows incluent un champ de sortie Code d'état qui indique la réussite ou l'échec d'un processus spécifique dans un flux actif. La sortie renvoyée par la carte est l'un des nombreux codes d'état de réponse HTTP possibles qui sont utilisés par le connecteur.

Les codes d'état de réponse HTTP appartiennent à l'une des cinq catégories suivantes.

Informationnel

Code

Poste

Description

100 Continuer La première partie d'une requête a été reçue et n'a pas encore été rejetée par le serveur. Le serveur a l'intention d'envoyer une réponse finale une fois que la requête aura été entièrement reçue et traitée.
101 Changer de protocole Le serveur comprend et accepte de satisfaire la requête du client, via le champ d'en-tête Mise à niveau, demandant un changement du protocole d'application utilisé sur cette connexion.

102

Traitement en cours Une réponse intermédiaire utilisée pour informer le client que le serveur a accepté la requête complète, mais ne l'a pas encore terminée.

103

Indications précoces Une réponse principalement utilisée avant que le reste de la réponse du serveur ne soit prêt.

Réussite

Code

Poste

Description

200 OK La requête a abouti. La signification spécifique de la réussite dépend de la méthode HTTP.
201 Date de création La requête a été traitée et a donné lieu à la création d'une ou de plusieurs nouvelles ressources.

202

Accepté La demande a été acceptée pour traitement, mais celui-ci n'est pas terminé. La requête peut ou non être traitée ultérieurement, car elle pourrait être rejetée lors du traitement effectif.

203

Informations ne faisant pas autorité La requête a abouti, mais la charge utile jointe a été modifiée par rapport à celle de la réponse 200 OK du serveur d'origine par un proxy de transformation.

204

Aucun contenu Le serveur a traité la requête avec succès et il n'y a pas de contenu supplémentaire à envoyer dans le corps de charge utile de la réponse.

205

Réinitialiser le contenu Le serveur a traité la demande et souhaite que l'agent utilisateur réinitialise l'« affichage du document », qui a entraîné l'envoi de la demande, à son état initial tel qu'il a été reçu du serveur d'origine.

206

Contenu partiel Le serveur traite avec succès une requête de plage pour la ressource cible en transférant une ou plusieurs parties de la représentation sélectionnée qui correspondent aux plages satisfaites trouvées dans le champ d'en-tête Plage de la requête.

207

État multiple Une réponse État multiple transmet des informations sur plusieurs ressources dans des situations où plusieurs codes d'état pourraient être appropriés.

208

Déjà signalé Une réponse utilisée dans un élément de réponse DAV : propstat pour éviter d'énumérer de manière répétée les membres internes de plusieurs liaisons à la même collection.

226

MI utilisé Le serveur a rempli une requête GET pour la ressource, et la réponse est une représentation du résultat d'une ou de plusieurs manipulations d'instance appliquées à l'instance actuelle.

Redirections

Code

Poste

Description

300 Choix multiples La ressource cible possède plus d'une représentation, chacune avec son propre identifiant plus spécifique, et des informations sur les alternatives sont fournies afin que l'utilisateur (ou l'agent utilisateur) puisse sélectionner une représentation préférée en redirigeant sa requête vers l'un ou plusieurs de ces identifiants.
301 Déplacé(e) de manière permanente Un nouvel URI permanent a été attribué à la ressource cible et toute référence ultérieure à cette ressource devrait utiliser l'un des URI joints.

302

Identifié(e) La ressource cible se trouve temporairement sous un URI différent. Étant donné que la redirection peut être modifiée à tout moment, le client doit continuer à utiliser l'URI de requête effectif pour les requêtes futures.

303

Consultez Autre Le serveur redirige l'agent utilisateur vers une ressource différente, comme indiqué par un URI dans le champ d'en-tête Emplacement, lequel est destiné à fournir une réponse indirecte à la requête originale.

304

Non modifié Une requête GET ou HEAD conditionnelle a été reçue et aurait abouti à une réponse 200 OK si la condition n'avait pas été évaluée comme fausse.

305

Utiliser un proxy Défini dans une version précédente de cette spécification et est désormais obsolète en raison de problèmes de sécurité concernant la configuration dans la bande d'un proxy.

307

Redirection temporaire La ressource cible se trouve temporairement sous un URI différent et l'agent utilisateur ne DOIT PAS modifier la méthode de la requête s'il effectue une redirection automatique vers cet URI.

308

Redirection permanente Un nouvel URI permanent a été attribué à la ressource cible et toute référence ultérieure à cette ressource devrait utiliser l'un des URI joints.

Erreurs du client

Code

Poste

Description

400 Requête incorrecte Le serveur ne peut pas ou ne veut pas traiter la requête en raison d'un élément perçu comme une erreur du client (par exemple, une syntaxe de requête mal formée, un encadrement de message de requête non valide ou un routage de requête trompeur).
401 Non autorisé La requête n'a pas été appliquée car elle ne contient pas d'identifiants d'authentification valides pour la ressource cible.

403

Interdite Le serveur a compris la requête, mais refuse de l'autoriser.

404

Non trouvé Le serveur d'origine n'a pas trouvé de représentation actuelle pour la ressource cible ou ne souhaite pas divulguer qu'il en existe une.

405

Méthode non autorisée La méthode reçue dans la ligne de requête est connue par le serveur d'origine, mais elle n'est pas prise en charge par la ressource cible.

406

Non acceptable La ressource cible ne possède pas de représentation actuelle qui serait acceptable pour l'agent utilisateur, selon les champs d'en-tête de négociation proactive reçus dans la requête, et le serveur ne souhaite pas fournir de représentation par défaut.

407

Authentification du proxy requise Semblable au code 401 Unauthorized, mais indique que le client doit s'authentifier lui-même pour pouvoir utiliser un proxy.

408

Délai d'expiration de la requête Le serveur n'a pas reçu un message de requête complet dans le délai qu'il était prêt à attendre.

409

Conflit La requête n'a pas pu être terminée en raison d'un conflit avec l'état actuel de la ressource cible. Ce code est utilisé dans des situations où l'utilisateur pourrait être en mesure de résoudre le conflit et de soumettre à nouveau la requête.

410

Disparu La ressource cible n'est plus disponible sur le serveur d'origine et cette condition est susceptible d'être permanente.

411

Longueur requise Le serveur refuse d'accepter la requête sans valeur Content-Length définie.

412

Échec de la condition préalable Une ou plusieurs conditions indiquées dans les champs d'en-tête de la requête ont été évaluées comme fausses lors du test sur le serveur.

413

Charge utile trop grande Le serveur refuse de traiter une requête, car la charge utile de la requête est supérieure à ce que le serveur souhaite ou peut traiter.

414

URI requête trop long Le serveur refuse de traiter la requête car la cible de la requête est plus longue que ce que le serveur est prêt à interpréter.

415

Type de support non pris en charge Le serveur d'origine refuse de traiter la requête car la charge utile est dans un format qui n'est pas pris en charge par cette méthode sur la ressource cible.

416

Plage demandée non satisfaisable Aucune des plages indiquées dans le champ d'en-tête Plage de la requête ne chevauche l'étendue actuelle de la ressource sélectionnée, ou l'ensemble des plages demandées a été rejeté en raison de plages invalides ou d'une demande excessive de plages petites ou se chevauchant.

417

Échec de l'attente L'attente indiquée dans le champ d'en-tête Expect de la requête n'a pas pu être satisfaite par au moins un des serveurs entrants.

421

Requête mal acheminée La requête a été redirigée vers un serveur qui n'est pas en mesure de produire une réponse. Ce message peut être envoyé par un serveur qui n'est pas configuré pour produire des réponses pour la combinaison de protocole et d'autorité inclus dans l'URI de la requête.

422

Entité non traitable La ressource source ou de destination d'une méthode est verrouillée.

423

Verrouillé La ressource source ou de destination d'une méthode est verrouillée.

424

Dépendance échouée La méthode n'a pas pu être exécutée sur la ressource car l'action demandée dépendait d'une autre action, et cette dernière a échoué.

425

Trop tôt Le serveur refuse de risquer le traitement d'une requête qui pourrait être rejouée.

426

Mise à niveau requise Le serveur refuse d'exécuter la requête en utilisant le protocole actuel, mais pourrait être disposé à le faire une fois que le client sera passé à un protocole différent.

428

Condition préalable obligatoire Le serveur d'origine exige que la requête soit conditionnelle.

429

Trop de requêtes L'utilisateur a envoyé un trop grand nombre de requêtes dans un délai donné (« seuil de protection »).

431

Champs de l'en-tête de la requête trop volumineux Le serveur ne souhaite pas traiter la requête, car ses champs d'en-tête sont trop volumineux. La requête PEUT être soumise à nouveau après avoir réduit la taille de ses champs d'en-tête.

451

Indisponible pour des raisons juridiques Le serveur refuse l'accès à la ressource en conséquence d'une demande légale.

Erreurs de serveur

Code

Poste

Description

500 Erreur interne du serveur Le serveur a rencontré une condition inattendue qui l'a empêché de répondre à la requête.
501 Non implémenté Le serveur ne prend pas en charge la fonctionnalité requise pour répondre à la requête.

502

Passerelle incorrecte Le serveur, agissant en tant que passerelle ou proxy, a reçu une réponse invalide de la part d'un serveur entrant auquel il a accédé en tentant de répondre à la requête.

503

Service non disponible Le serveur est actuellement incapable de traiter la requête en raison d'une surcharge temporaire ou d'une maintenance planifiée, une situation qui sera probablement rétablie après un certain délai.

504

Délai d'expiration de la passerelle Le serveur, agissant en tant que passerelle ou proxy, n'a pas reçu de réponse en temps voulu de la part d'un serveur en amont auquel il devait accéder pour terminer la requête.

505

Version HTTP non prise en charge e serveur ne prend pas en charge, ou refuse de prendre en charge, la version majeure de HTTP utilisée dans le message de la requête.

506

La variante est également négociable Le serveur comporte une erreur de configuration interne : la ressource de variante choisie est configurée de façon à s'engager elle-même dans une négociation de contenu transparente et ne constitue donc pas un point de terminaison approprié dans le processus de négociation.

507

Stockage insuffisant La méthode n'a pas pu être exécutée sur la ressource car le serveur est incapable de stocker la représentation nécessaire pour mener à bien la requête.

508

Boucle détectée Le serveur a interrompu une opération, car il a rencontré une boucle infinie lors du traitement d'une requête avec « Depth: infinity ». Cet état indique que l'opération a échoué.

510

Non étendu La politique d'accès à la ressource n'a pas été respectée dans la requête. Le serveur doit renvoyer toutes les informations nécessaires pour que le client puisse émettre une requête étendue.

511

Authentification réseau requise Le client doit s'authentifier pour obtenir l'accès au réseau.