1

I was trying to find if there is some kind of reference about what type of informations are important to be passed on the HTTP Header.

I understand that some information seems natural to be there, like the Authorization, Content-Type, Accept, and so on.

Some articles explains that the HTTP Header are used to send optional or additional informations about the request.

What I understand about the HTTP Header objetive is: send informations that are useful for all (or almost all) requests made to the API.

But all this continues to be very vague to me.

Many APIs use them to pass additional information about the authorized user and, of course, the Authorization header. But pass the authorization/user informations on HTTP Headers is a generalized concept for me. I'm looking for an explanation that could clarify the use (or not) for specific API problems.

Per example, see this question. I'm sure that the platform and user could be send through the HTTP Headers (even I prefer the URL), but if the platform and user reference are used for all endpoints on the API, maybe the HTTP Header could be a reasonable place to put them.

Is there some reference about what kind of situations the HTTP Header could be used? What you guys understand about the HTTP Header use?

asked Mar 27, 2018 at 23:38
11
  • 6
    You should use HTTP headers when information is related to communication itself rather than the matter of request. So things like encoding, caching, language, authorization are good examples of communication details. Commented Mar 28, 2018 at 9:40
  • @kadiii, this kind of information I'm aware. My question is about use the HTTP Headers to resolve API specific problems (as described in my example). Commented Mar 28, 2018 at 12:34
  • 2
    @Dherik The definition is generic like in such a specifications but also very precise. You can include additional information about the request (like e.g. encoding, authorization,) and information about the client itself (like e.g. Accept Type). Commented Mar 28, 2018 at 13:06
  • 1
    Headers don't provide information related to the "business" (ideally). They rather provide information and instructions related to the "act" of exchanging messages. client: I do request the URI and I expect to get it in JSON format, only if the response has been modified since. And please, don't cache further responses to this URI. Server: Ok, I accept your request as soon as you provide me with the message in JSON format and you are authorized Commented Mar 28, 2018 at 13:26
  • 2
    Possible duplicate of What belongs in an HTTP request header vs the request body? Commented Sep 10, 2018 at 19:40

0

Know someone who can answer? Share a link to this question via email, Twitter, or Facebook.

Your Answer

Draft saved
Draft discarded

Sign up or log in

Sign up using Google
Sign up using Email and Password

Post as a guest

Required, but never shown

Post as a guest

Required, but never shown

By clicking "Post Your Answer", you agree to our terms of service and acknowledge you have read our privacy policy.

Start asking to get answers

Find the answer to your question by asking.

Ask question

Explore related questions

See similar questions with these tags.