People First API usage guide

Collection resources SHOULD be paginated by default. When a resource is paginated it MUST provide the following links in the links meta object:

• first
• last
• prev (MUST NOT be provided on the first page)
• next (MUST NOT be provided on the last page)

It MUST also provide the correct pagination meta data. Finally, the resource MUST also accept the following query parameters:

• page[offset]: The page index to return (zero indexed)
• page[limit]: The number of resources to return per page

{
  "data": {
    "people": [
      {
        "id": "031c0575-ed2e-4e04-bd01-cc7565045d8b",
        "type": "person",
        "firstName": "Susan",
        "lastName": "Smith",
        "_links": {
          "self": {
            "href": "people/031c0575-ed2e-4e04-bd01-cc7565045d8b"
          }
        }
      },
      {
        "id": "80e3ef54-2905-42f7-87ac-eaaed55df144",
        "type": "person",
        "firstName": "David",
        "lastName": "Jones",
        "_links": {
          "self": {
            "href": "people/80e3ef54-2905-42f7-87ac-eaaed55df144"
          }
        }
      }
    ]
  },
  "meta": {
    "totalPages": 5,
    "pageNumber": 2,
    "pageSize": 2,
    "maxPageSize": 100,
    "count": 10,
    "links": {
      "self": {
        "href": "people"
      },
      "next": {
        "href": "people?page%5Boffset%5D=4&page%5Blimit%5D=2"
      },
      "prev": {
        "href": "people?page%5Boffset%5D=0&page%5Blimit%5D=2"
      },
      "last": {
        "href": "people?page%5Boffset%5D=8&page%5Blimit%5D=2"
      },
      "first": {
        "href": "people?page%5Boffset%5D=0&page%5Blimit%5D=2"
      }
    }
  }
}