Sobre o 207 Multi-Status
Visão Geral do 207 Multi-Status
| Fornecer resultados de múltiplas operaçõesCódigo de Status HTTP | ||
|
207 Multi-Status Visão Geral O código de status HTTP 207 Multi-Status é utilizado para retornar os status de múltiplos recursos em resposta a uma única solicitação. Este código é empregado principalmente no protocolo WebDAV, onde a resposta é formatada em XML e fornece informações detalhadas sobre cada recurso. |
||
| Significado A solicitação do cliente retorna os status de múltiplos recursos. |
Quando o 207 Multi-Status é Retornado?
- Quando operações do WebDAV retornam resultados para múltiplos recursos em uma única resposta
- Quando são necessários status diferentes para cada recurso especificado na solicitação
- Quando os resultados de um processamento em lote são consolidados em uma única resposta
Exemplos de 207 Multi-Status
Relatar Status de Múltiplos Recursos no WebDAV
PROPFIND /files/ HTTP/1.1 Host: example.com
Exemplo de Resposta:
HTTP/1.1 207 Multi-Status
Content-Type: application/xml; charset=UTF-8
<?xml version="1.0" encoding="UTF-8"?>
<multistatus xmlns="DAV:">
<response>
<href>/files/file1.txt</href>
<status>HTTP/1.1 200 OK</status>
</response>
<response>
<href>/files/file2.txt</href>
<status>HTTP/1.1 404 Not Found</status>
</response>
</multistatus>
Explicação: Quando um cliente tenta recuperar as propriedades de todos os recursos dentro de um diretório, o código 207 é retornado. A resposta, no formato XML, fornece os status individuais para cada recurso.
Resultados de Operações em Lote
POST /batch HTTP/1.1
Host: example.com
Content-Type: application/json
{ "operations": [
{ "action": "delete", "resource": "/file1.txt" },
{ "action": "delete", "resource": "/file2.txt" }
]
}
Exemplo de Resposta:
HTTP/1.1 207 Multi-Status
Content-Type: application/json
{ "results": [
{ "resource": "/file1.txt", "status": "200 OK" },
{ "resource": "/file2.txt", "status": "404 Not Found" }
]
}
Explicação: Quando um cliente solicita múltiplas operações e os resultados variam para cada uma delas, o código 207 é utilizado. A resposta, no formato JSON, fornece os resultados de cada recurso.
Pontos Importantes
Considerações ao retornar o 207 Multi-Status:
- Mantenha o formato da resposta consistente
Forneça os resultados para cada recurso em um formato consistente, como XML ou JSON. - Defina claramente os status individuais
Descreva os status de cada recurso de forma clara para que o cliente possa analisar os resultados com precisão.
Comparação com Códigos de Status HTTP Relacionados
Descrição de códigos de status relacionados ao 207 Multi-Status:
- 200 OK: Indica sucesso para um único recurso.
- 404 Not Found: Usado quando um recurso especificado não pode ser encontrado, frequentemente aparece dentro de uma resposta 207 para recursos individuais.
Compreender essas diferenças garante o uso adequado do código de status 207.