207 Multi-Status

Formulation

Description

Ce code d'erreur permet d'indiquer que la page a de multiple état.

Remarques

• Une réponse multi-états transmet des informations sur plusieurs ressources dans des situations où plusieurs codes d'état peuvent être appropriés. Le corps de réponse multi-états par défaut est une entité HTTP text/xml ou application/xml avec un élément racine multistatus. D'autres éléments contiennent des codes d'état des séries 200, 300, 400 et 500 générés lors de l'appel de la méthode. Les codes d'état de la série 100 ne devraient pas être enregistrés dans un élément XML «response».
• Bien que le 207 soit utilisé comme code d'état de réponse global, le destinataire doit consulter le contenu du corps de réponse multi-états pour plus d'informations sur le succès ou l'échec de l'exécution de la méthode. La réponse peut être utilisée en cas de succès, de succès partiel et également en cas d'échec.
• L'élément racine «multistatus» contient zéro ou plusieurs éléments «response» dans n'importe quel ordre, chacun contenant des informations sur une ressource individuelle. Chaque élément «response» doit avoir un élément «href» pour identifier la ressource.
• Une réponse multi-états utilise un des deux formats distincts pour représenter l'état : Un élément «status» en tant qu'enfant de l'élément «response» indique l'état de l'exécution du message pour la ressource identifiée dans son ensemble. Certaines définitions de méthode fournissent des informations sur des codes d'état spécifiques que les clients doivent être prêts à voir dans une réponse. Cependant, les clients doivent être capables de gérer d'autres codes d'état, en utilisant les règles génériques. Pour PROPFIND et PROPPATCH, le format a été étendu en utilisant l'élément 'propstat' au lieu de 'status', fournissant des informations sur les propriétés individuelles d'une ressource. Ce format est spécifique à PROPFIND et PROPPATCH.