This guide contains a couple of examples about using the Auxiliaries in Paging for Collection Resources.

Implementation Tips

The paging for collection resources can be improved via the following tips:

• Enable paging for collection resources by default – even if paging constraints are not provided in the request.
• Do not include offset, limit or any navigational links if the collection resource is empty.
• Validate offset and limit even if the collection resource is empty, but always allow the retrieval of the first page of the collection resource – in general, the client should follow the navigational links and not hard code the URI for any page but the first.
• When generating the page accessor identifier, use the session identifier and the base request path; include query parameters only if they represent filtering constraints that will affect the elements in the cached collection.
• When generating the navigational links, include the various query parameters from the request that represent filtering and representation constraints, thus consequent requests towards the provided links will enable processing the same criteria as the initial request.