This method is a slight variation on the next page URL approach. Instead of receiving a full URL in the response, it contains a 'token' (usually a random string/hash). The receiving system uses this token to keep track of the position of the last record in the current page of data.
| Option | Summary |
|---|---|
Suppose we set the following options:
| Option | Value |
|---|---|
...and we send a request to get the first page of data:
The response will include the first page of data, together with a next page token that should be used to get the next page of results. For example:
Notice the links.next section at the end of this response, which includes our next page URL. So, our request for the next page of results would be:
Pagination continues until the token is no longer included in the payload.
The next page token pagination method is implemented using a Patchworks pagination variable which contains a token for the next page:
This note is for reference only - there should never be a need to access/change this variable.
Token parameter name
Enter the name of the URL parameter which holds the token for requesting the next page.
Limit parameter path
Enter the dot notation path for the data element in your response which contains the maximum number of items that the API should return in a single page of a paginated response. Commonly (though not necessarily), this would be a path to a limit field.
Limit
Enter the number of items to be returned per page. For example: 10.
Path to token in payload
Enter the dot notation path of the next page token within the payload.
Token parameter name
page_token
Limit parameter path
limit
Limit
10
Path to token in payload
links.next