Api principles (preliminary, very rough draft)

I'm kind of on the fence on this. I've seen both in various API examples, and people avocating either way.

One view is that the current page and page size is data (the payload is a representation of part of the collection, and which part of the collection we're returning is intrinsically relevant); but the total number of pages is metadata.

But then it feels weird to separate them.