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

Http HeadersHttp Status-CodesHttp Status-Code-403Http Status-Code-400

Http Headers Problem Overview


I read https://stackoverflow.com/questions/3050518/what-http-status-response-code-should-i-use-if-the-request-is-missing-a-required 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.

Http Headers Solutions


Solution 1 - Http Headers

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.

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionDavid PedenView Question on Stackoverflow
Solution 1 - Http HeadersTim PoteView Answer on Stackoverflow