Add paging information and total count to API response

[fhemberger]

It would be nice if the API response included the paging settings used and total page count, so my client can determine, if it needs to make an additional request, e.g.

{
	"links": […],
	"paging": {
		// Also include default setting if parameter was omitted
		"per-page": 20,
		"page": 0,
		// Total pages, depending on 'per-page'
		"total": 5
	}
}

[rubenwardy]

I agree with this - I didn't even realise the results were paginated. Would be a good idea to document this next to the API endpoint doc too