Document `x-apify-pagination` headers

[jirimoravcik]

We should properly document x-apify-pagination headers (and also all other Apify-related) headers. We should explain the use-cases for them, etc.

NOTE: This fits into the API docs part of the docs