Merge pull request #33 from lmeunier/pagination

Add server based pagination support
added pagination documentation to the readme
Add information about pages and items in the current page

The pagination object stored in the metadata now contains more
information:
- total number of pages
- index of the first item in the page
- index of the last item in the page
- number or items per page