Skip to main content

Получение всех бронирований

Создайте начальный запрос данных​

Укажите начало и конец периода. Важно передать его без параметра pageToken.

Запрос:

GET /api/pms/reservations/search?state=Active&startAffectPeriodDateTime=2024-10-21T11:11&endAffectPeriodDateTime=2024-11-22T11:11 HTTP/1.1
Host: partner.tlintegration.com
Authorization: Bearer {{access_token}}

Ответ:

{
  "pageToken": "eyJCb29raW5nSWRzIjpbMTIwNDAzMzNdLCJNaWxsaXNlY29uZHNGcm9tIjoxNjg3NDM3NTIwMjEwfQ==",
  "hasNextPage": true,
  "reservations": [
    {
      "number": "20230622-7291-12025196",
      "propertyId": 7291,
      "status": "Active",
      "createdDateTime": "2023-06-21T05:17:16Z",
      "modifiedDateTime": "2023-06-21T05:17:16Z"
    },
    {
      "number": "20230622-7291-12025552",
      "propertyId": 7291,
      "status": "Cancelled",
      "createdDateTime": "2023-06-21T05:27:35Z",
      "modifiedDateTime": "2023-06-21T05:30:12Z"
    },
    {
      "number": "20230622-7291-12039864",
      "propertyId": 7291,
      "status": "Active",
      "createdDateTime": "2023-06-22T10:50:40Z",
      "modifiedDateTime": "2023-06-22T10:51:40Z"
    },
    {
      "number": "20230810-7291-12039886",
      "propertyId": 7291,
      "status": "Active",
      "createdDateTime": "2023-06-22T10:58:15Z",
      "modifiedDateTime": "2023-06-22T10:58:15Z"
    },
    {
      "number": "20230822-7291-12040332",
      "propertyId": 7291,
      "status": "Active",
      "createdDateTime": "2023-06-22T12:36:30Z",
      "modifiedDateTime": "2023-06-22T12:38:40Z"
    },
    ...
  ]
}

Обработайте ответ и извлеките pageToken​

API возвращает данные вместе с nextPageToken, который указывает, как получить следующий набор данных.

Используйте nextPageToken для получения следующего набора данных​

Теперь, когда у вас есть nextPageToken, используйте его в следующем запросе для получения следующих данных.

{
    "pageToken": "eyJCb29raW5nSWRzIjpbMTIwNDg3MDFdLCJNaWxsaXNlY29uZHNGcm9tIjoxNjg3NTExMTA4NzgzfQ==",
    "hasNextPage": true,
    "reservations": [
        {
            "number": "20230622-7291-12040458"
        },
        {
            "number": "20230722-7291-12034091"
        },
        {
            "number": "20230723-7291-12048663"
        },
        {
            "number": "20230723-7291-12048673"
        },
        {
            "number": "20230723-7291-12048701"
        },
        ...
    ]
}

Повторите процесс​

Продолжайте использовать полученный nextPageToken из каждого последующего ответа, пока не получите все необходимые данные или флаг hasNextPage = false

Ответ:

{
    "pageToken": "eyJCb29raW5nSWRzIjpbMTg0OTQ5OTVdLCJNaWxsaXNlY29uZHNGcm9tIjoxNzQyNTYxMzk2ODMzfQ==",
    "hasNextPage": false,
    "reservations": [
        {
            "number": "20250427-7291-18494992
        },
        {
            "number": "20250515-7291-18494994"
        }
    ]
}

Используйте nextPageToken для получения новых данных​

После получения последней страницы данных, в ответе будет возвращен флаг hasNextPage = false, который указывает, что дополнительных данных для загрузки больше нет. Однако, вместе с этим флагом, вы также получите новый nextPageToken. Этот токен может быть использован позже для получения новых бронирований, появившихся после вашего последнего запроса.

Запрос:

GET /api/pms/reservations/search?pageToken=eyJCb29raW5nSWRzIjpbMTg0OTQ5OTVdLCJNaWxsaXNlY29uZHNGcm9tIjoxNzQyNTYxMzk2ODMzfQ== HTTP/1.1
Host: partner.tlintegration.com
Authorization: Bearer {{access_token}}

Ответ:

{
  "nextPageToken": "eyJCb29raW5nSWRzIjpbMTg0OTU1NjFdLCJNaWxsaXNlY29uZHNGcm9tIjoxNzQyNTY4MTExOTcwfQ==",
  "hasNextPage": false,
  "reservations": [
    {
      "number": "20250321-7291-18495561",
      "propertyId": 7291,
      "status": "Active",
      "createdDateTime": "2025-03-21T14:41:51Z",
      "modifiedDateTime": "2025-03-21T14:41:51Z"
    }
  ]
}