Получение списка отзывов

Получение последних отзывов

Запрос:

GET /api/reputation-public-reviews/v1/properties/7291/reviews?maxPageSize=20&sortBy=date&sortOrder=desc HTTP/1.1
Host: partner.tlintegration.com
Authorization: Bearer {{access_token}}

Параметры:

Параметр	Тип	Обязательный	Описание
propertyId	string	Да	Идентификатор объекта размещения (в пути запроса)
maxPageSize	integer	Нет	Количество отзывов на странице (по умолчанию: 10, максимум: 100)
sortBy	string	Нет	Поле сортировки: date или rate (по умолчанию: date)
sortOrder	string	Нет	Порядок сортировки: asc или desc (по умолчанию: desc)

Ответ:

{
  "reviews": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "authorName": "Irina Zadirskaia",
      "publishDate": "2025-07-30T00:00:00",
      "rating": 9.5,
      "originalText": "Отдыхали здесь с 14 по 23 июля 2025 года...",
      "languageCode": "ru",
      "sourceId": "16",
      "replyText": "Ирина, приветствуем Вас! Благодарим Вас за выбор нашего отеля...",
      "translatedText": null
    }
  ],
  "nextPageToken": "eyJwYWdlIjoyfQ==",
  "hasNextPage": true
}

---

Получение отзывов с переводом

Запрос:

GET /api/reputation-public-reviews/v1/properties/7291/reviews?maxPageSize=20&languageCode=en HTTP/1.1
Host: partner.tlintegration.com
Authorization: Bearer {{access_token}}

Параметры:

Параметр	Тип	Обязательный	Описание
languageCode	string	Нет	Код языка перевода (IETF BCP-47, например: en, de, fr)

Ответ:

{
  "reviews": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "authorName": "Irina Zadirskaia",
      "publishDate": "2025-07-30T00:00:00",
      "rating": 9.5,
      "originalText": "Отдыхали здесь с 14 по 23 июля 2025 года...",
      "languageCode": "ru",
      "sourceId": "16",
      "replyText": "Ирина, приветствуем Вас! Благодарим Вас за выбор нашего отеля...",
      "translatedText": "We had a rest here from July 14 to July 23, 2025..."
    }
  ],
  "nextPageToken": "eyJwYWdlIjoyfQ==",
  "hasNextPage": true
}

---

Пагинация - получение следующей страницы

Запрос:

GET /api/reputation-public-reviews/v1/properties/7291/reviews?maxPageSize=20&pageToken=eyJwYWdlIjoyfQ== HTTP/1.1
Host: partner.tlintegration.com
Authorization: Bearer {{access_token}}

Параметры:

Параметр	Тип	Обязательный	Описание
pageToken	string	Нет	Токен для получения следующей страницы

Примечание: При использовании pageToken параметры сортировки (sortBy, sortOrder) игнорируются.