Acerca de 207 Multi-Status
Resumen de 207 Multi-Status
| Proporcionar resultados de múltiples operacionesCódigo de Estado HTTP | ||
|
207 Multi-Status Resumen El código de estado HTTP 207 Multi-Status se utiliza para devolver el estado de múltiples recursos en respuesta a una sola solicitud. Este código se emplea principalmente en el protocolo WebDAV, donde la respuesta está en formato XML y proporciona información detallada sobre cada recurso. |
||
| Significado La solicitud del cliente devuelve estados de múltiples recursos. |
¿Cuándo se devuelve 207 Multi-Status?
- Cuando las operaciones de WebDAV devuelven resultados para múltiples recursos en una sola respuesta
- Cuando se necesitan estados diferentes para cada recurso especificado en la solicitud
- Cuando los resultados de un procesamiento por lotes se consolidan en una única respuesta
Ejemplos de 207 Multi-Status
Reportar estados de múltiples recursos en WebDAV
PROPFIND /files/ HTTP/1.1 Host: example.com
Ejemplo de respuesta:
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>
Explicación: Cuando un cliente intenta recuperar las propiedades de todos los recursos dentro de un directorio, se devuelve el código 207. La respuesta está en formato XML y proporciona estados individuales para cada recurso.
Resultados de una operación por lotes
POST /batch HTTP/1.1
Host: example.com
Content-Type: application/json
{ "operations": [
{ "action": "delete", "resource": "/file1.txt" },
{ "action": "delete", "resource": "/file2.txt" }
]
}
Ejemplo de respuesta:
HTTP/1.1 207 Multi-Status
Content-Type: application/json
{ "results": [
{ "resource": "/file1.txt", "status": "200 OK" },
{ "resource": "/file2.txt", "status": "404 Not Found" }
]
}
Explicación: Cuando un cliente solicita múltiples operaciones y los resultados varían para cada una, se utiliza el código 207. La respuesta, en formato JSON, proporciona el resultado para cada recurso.
Puntos importantes
Consideraciones al devolver 207 Multi-Status:
- Mantener la consistencia del formato de respuesta
Proporcione resultados para cada recurso en un formato consistente, como XML o JSON. - Definir claramente los estados individuales
Describa claramente el estado de cada recurso para que el cliente pueda analizar los resultados con precisión.
Comparación con códigos de estado HTTP relacionados
Descripción de códigos de estado relacionados con 207 Multi-Status:
- 200 OK: Indica éxito para un único recurso.
- 404 Not Found: Se utiliza cuando no se encuentra un recurso especificado, a menudo aparece dentro de una respuesta 207 para recursos individuales.
Comprender estas diferencias asegura el uso adecuado del código de estado 207.