Api principles (preliminary, very rough draft)

I think it's what @mezis meant: metadata goes in the headers, pagination stuff is in the body. At least that's what I read there, but I may be getting it wrong.