Api principles (preliminary, very rough draft)

Headers are not meant to include values like total number of results. As usual it's a matter of taste, some people really like to pass lot of stuff within the headers, I'm personally more inclined to use the body since it's easier to read.