Api principles (preliminary, very rough draft)

re: pagination - If there is no strong winner (headers versus body) and its just a theoretical argument I would go for body since it is more practical and it is where you would expect to find it.