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
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
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?