¿Qué código de estado HTTP usar para los parámetros requeridos no provistos?

Question

Tengo varias páginas diseñadas para ser llamadas con AJAX - Les pido que devuelvan un código de estado anormal si no se pueden mostrar, y mi javascript mostrará un cuadro de error en consecuencia.

Por ejemplo, si el usuario no está autenticado o si su sesión ha expirado y tratan de llamar a una de las páginas AJAX, devolverá 401 Unathorized.

También tengo alguna devolución 500 Internal Server Error si algo realmente extraño sucede en el servidor.

¿Qué código de estado debo devolver si se llamó a una de estas páginas sin los parámetros necesarios? (y por lo tanto no puede devolver ningún contenido).

que tenía un aspecto en el wikipedia article on HTTP status codes, pero la más cercana que pude encontrar para el código que estoy buscando era la siguiente:

422 Unprocessable Entity
The request was well-formed but was unable to be followed due to semantic errors.

Editar: El código anterior es WebDAV específica y por lo tanto poco probable que ser apropiado en este caso

¿Alguien puede pensar en un código apropiado para regresar?

Answer 1

What status code should I return if one of these pages was called without required parameters? (and therefore can't return any content).

usted podría escoger 404 Not Found:

The server has not found anything matching the Request-URI [assuming your required parameters are part of the URI, i.e. $_GET ]. No indication is given of whether the condition is temporary or permanent. The 410 (Gone) status code SHOULD be used if the server knows, through some internally configurable mechanism, that an old resource is permanently unavailable and has no forwarding address. This status code is commonly used when the server does not wish to reveal exactly why the request has been refused, or when no other response is applicable.

(resaltado por mí)

404 Not Found es un subconjunto de 400 Bad Request que podría tomarse así porque es muy claro acerca de lo que es esto:

The request could not be understood by the server due to malformed syntax. The client SHOULD NOT repeat the request without modifications.

No puedo sugerir que lo que hace ka Código de respuesta WEBDAV que no existe para los clientes HTTP que usan hipertexto, pero podría, es totalmente válido, usted es el codificador del servidor, puede tomar cualquier código de estado de resonse HTTP que considere adecuado para su cliente HTTP del cual usted es el diseñador también:

11.2. 422 Unprocessable Entity

The 422 (Unprocessable Entity) status code means the server understands the content type of the request entity (hence a 415(Unsupported Media Type) status code is inappropriate), and the syntax of the request entity is correct (thus a 400 (Bad Request) status code is inappropriate) but was unable to process the contained instructions. For example, this error condition may occur if an XML request body contains well-formed (i.e., syntactically correct), but semantically erroneous, XML instructions.

entidad de solicitud de IIRC es el cuerpo de la solicitud. Entonces, si estás operando con cuerpos de solicitud, podría ser apropiado como escribió Julian.

---

Ha comentado:

IMHO, the text for 400 speaks of malformed syntax. I would assume the syntax here relates to the syntax of HTTP string that the client sends across to the server.

Eso podría ser, pero puede ser cualquier cosa expresada sintácticamente, toda la solicitud, sólo algunas cabeceras de petición, o una cabecera de la solicitud específica, la petición URI etc .. 400 no está específicamente sobre "sintaxis de cadena HTTP", es de hecho la respuesta general a un error del cliente:

The 4xx class of status code is intended for cases in which the client seems to have erred. Except when responding to a HEAD request, the server SHOULD include an entity containing an explanation of the error situation, and whether it is a temporary or permanent condition. These status codes are applicable to any request method. User agents SHOULD display any included entity to the user.

la parte importante es ahí donde se debe decirle al cliente lo que salió mal. El código de estado solo indica que algo salió mal (en la clase 4xx), pero HTTP no se ha diseñado específicamente para hacer que un parámetro de parte consulta-información faltable como una condición de error.De hecho, URI solo sabe que hay una parte consulta-info y no lo que significa.

Si crees que 400 es demasiado amplio, te sugiero que elijas 404 si el problema está relacionado con el URI, p. $_GET variables.

Answer 2

No sé acerca de las intenciones de los escritores RFC, pero el código de estado que he visto utilizado en la naturaleza para ese caso es 400 Bad Request.

Answer 3

Lee esto cuidadosamente:

https://en.wikipedia.org/wiki/List_of_HTTP_status_codes

422 es una cosa-WebDAV específica, y no he visto que se usa para otra cosa.

400, aunque no esté destinado a este fin en particular, parece ser una opción común.

404 es también una opción viable si su API es REST o similar (utilizando la parte de la ruta de la URI para indicar parámetros de búsqueda)

Answer 4

Descripción citado contra 400

The request could not be understood by the server due to malformed syntax. The client SHOULD NOT repeat the request without modifications.

(El énfasis es mío)

Habla de sintaxis mal formada, que no es el caso cuando el navegador envía una solicitud al servidor. Es solo el caso de los parámetros faltantes (mientras que no hay sintaxis mal formada).

Yo sugeriría palo con 404 :)

(Expertos corrígeme si estoy equivocado en cualquier lugar :))

Answer 5

422 es un código de estado HTTP normal; y es es usado fuera de WebDAV. Al contrario de lo que otros dicen, no hay problema con eso; HTTP tiene un registro de código de estado por una razón.

Ver http://www.iana.org/assignments/http-status-codes