Return modified dialogportal™ entities for a search session specified by a token identifier.The search session is started by calling endpoint 1012: Create changed since session, which returns a token identifier.
The session is created asynchronously, so may not immediately be ready to access. When this endpoint is called for an incomplete session, a 204 response is returned instead of the 200 response which indicates a successful fetch. In this situation it is recommended to wait a few seconds, and try again.
The search session has an expiry of 1 hour. Any request to this endpoint for the session will refresh the expiry, but after an hour of inactivity the session may be deleted.
| Endpoint ID: | 1013 | ||||||||||
| Method: | POST | ||||||||||
| URL: | /user/changes/token/{token} | ||||||||||
| token | The session token to fetch data for | ||||||||||
| Request body: | JSON data with search settings
{}
{
"offset": 0,
"limit": 3
}
| ||||||||||
Response body: | JSON data with an array of
{
"entities": [
{
"dpKey": 12345,
"updatedDate": "2015-06-03T12:55:02"
},
{
"dpKey": 12346,
"updatedDate": "2015-06-03T13:10:47"
},
{
"dpKey": 12347,
"updatedDate": "2015-06-04T01:02:55"
}
],
"paging": {
"offset": 0,
"count": 3,
"more": true
}
}
| ||||||||||
| Status codes: | 200 | One or more entities were found | |||||||||
| 204 | The search session is not yet complete - please wait a few seconds and try again | ||||||||||
| 404 | The search session contains no entities, or contains no entities for the given Additionally the following sub code may be returned:
| ||||||||||