Skip to main content

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

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

В первичном запросе укажите параметр lastModification. Для получения данных, выполните первый запрос с помощью параметра lastModification. Пример: 2023-06-20T10:41:04Z. Важно передать его без параметра continueToken.

Запрос:

GET /api/read-reservation/v1/properties/7291/bookings?count=1000&lastModification=2023-06-20T10:41:04Z HTTP/1.1
Host: partner.tlintegration.com
Authorization: Bearer {{access_token}}

Ответ:

{
  "continueToken": "eyJCb29raW5nSWRzIjpbMTIwNDAzMzNdLCJNaWxsaXNlY29uZHNGcm9tIjoxNjg3NDM3NTIwMjEwfQ==",
  "hasMoreData": true,
  "bookingSummaries": [
    {
      "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"
    },
    ...
  ]
}

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

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

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

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

{
    "continueToken": "eyJCb29raW5nSWRzIjpbMTIwNDg3MDFdLCJNaWxsaXNlY29uZHNGcm9tIjoxNjg3NTExMTA4NzgzfQ==",
    "hasMoreData": true,
    "bookingSummaries": [
        {
            "number": "20230622-7291-12040458",
            "propertyId": 7291,
            "status": "Active",
            "createdDateTime": "2023-06-22T13:37:12Z",
            "modifiedDateTime": "2023-06-22T13:40:34Z"
        },
        {
            "number": "20230722-7291-12034091",
            "propertyId": 7291,
            "status": "Active",
            "createdDateTime": "2023-06-22T08:19:55Z",
            "modifiedDateTime": "2023-06-23T08:39:31Z"
        },
        {
            "number": "20230723-7291-12048663",
            "propertyId": 7291,
            "status": "Active",
            "createdDateTime": "2023-06-23T08:57:46Z",
            "modifiedDateTime": "2023-06-23T08:58:17Z"
        },
        {
            "number": "20230723-7291-12048673",
            "propertyId": 7291,
            "status": "Active",
            "createdDateTime": "2023-06-23T09:01:48Z",
            "modifiedDateTime": "2023-06-23T09:01:51Z"
        },
        {
            "number": "20230723-7291-12048701",
            "propertyId": 7291,
            "status": "Active",
            "createdDateTime": "2023-06-23T09:05:05Z",
            "modifiedDateTime": "2023-06-23T09:05:08Z"
        },
        ...
    ]
}

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

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

Ответ:

{
    "continueToken": "eyJCb29raW5nSWRzIjpbMTg0OTQ5OTVdLCJNaWxsaXNlY29uZHNGcm9tIjoxNzQyNTYxMzk2ODMzfQ==",
    "hasMoreData": false,
    "bookingSummaries": [
        {
            "number": "20250427-7291-18494992",
            "propertyId": 7291,
            "status": "Cancelled",
            "createdDateTime": "2025-03-21T12:48:58Z",
            "modifiedDateTime": "2025-03-21T12:49:18Z"
        },
        {
            "number": "20250515-7291-18494994",
            "propertyId": 7291,
            "status": "Cancelled",
            "createdDateTime": "2025-03-21T12:49:39Z",
            "modifiedDateTime": "2025-03-21T12:49:56Z"
        }
    ]
}

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

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

Запрос:

GET /api/read-reservation/v1/properties/7291/bookings?count=175&continueToken=eyJCb29raW5nSWRzIjpbMTg0OTQ5OTVdLCJNaWxsaXNlY29uZHNGcm9tIjoxNzQyNTYxMzk2ODMzfQ== HTTP/1.1
Host: partner.tlintegration.com
Authorization: Bearer {{access_token}}

Ответ:

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