http-headershttp-status-codeshttp-status-code-403http-status-code-400

What is the most appropriate HTTP status code to return if a required header is missing?


I read What HTTP status response code should I use if the request is missing a required parameter? but it did not specifically ask about headers and there didn't seem to be a consensus.

The context of this question assumes successful authentication. I'm currently favoring either a 400 (though that doesn't feel right because this isn't really a case of "malformed syntax") or 403. Given 403's description:

The server understood the request, but is refusing to fulfill it. Authorization will not help and the request SHOULD NOT be repeated. If the request method was not HEAD and the server wishes to make public why the request has not been fulfilled, it SHOULD describe the reason for the refusal in the entity.

This makes the most sense to me.

Can someone please enlighten me? Thanks.


Solution

  • 400 Bad Request

    It's a user error in the request. Unlike with a 403, the client should be allowed to repeat their request, but only after modification:

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

    Edit

    As Mark Reed points out in the comments, a 403 says, "There is nothing wrong with what you sent me. You have proper authorization and the syntax was valid. I just don't want to do what you ask."

    The part that you have in bold simply says, if the server so chooses, it can tell the client exactly why it doesn't want to fulfill the request.