Получение статистики отзывов
Получение общей статистики
Запрос:
GET /api/reputation-public-reviews/v1/properties/7291/reviews/stats HTTP/1.1
Host: partner.tlintegration.com
Authorization: Bearer {{access_token}}
Параметры:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
propertyId | string | Да | Идентификатор объекта размещения (в пути запроса) |
Ответ:
{
"averageRating": 9.2,
"reviewsCount": 3985
}
Описание полей ответа:
| Поле | Тип | Описание |
|---|---|---|
averageRating | decimal | Средний рейтинг по 10-балльной шкале |
reviewsCount | integer | Общее количество отзывов |
Использование статистики
Статистика отзывов используется для:
- Отображения общего рейтинга отеля на сайте
- Показа количества отзывов как индикатора популярности
- Сравнения рейтингов между разными объектами размещения
- Анализа динамики изменения репутации
Пример интеграции:
// Получение статистики
const stats = await fetch('/api/reputation-public-reviews/v1/properties/7291/reviews/stats', {
headers: {
'Authorization': 'Bearer ' + accessToken
}
});
const data = await stats.json();
// Отображение рейтинга
document.getElementById('rating').textContent = data.averageRating.toFixed(1);
document.getElementById('reviews-count').textContent = data.reviewsCount;