Модель данных
Всё в Rewio держится на трёх сущностях: объект, ссылка, отзыв.
В адресах и параметрах API объект называется группой: group_id, /v2/groups. Это одно и то же.
Объект «Гранд Отель» (group_id: 20)
├── Ссылка → Яндекс Карты (link_id: 181, source_id: 1) → отзывы…
├── Ссылка → 2ГИС (link_id: 182, source_id: 3) → отзывы…
└── Ссылка → Otzovik (link_id: 183, source_id: 202) → отзывы…Объект – ваша конкретная бизнес-сущность: один отель, одна клиника, один врач, один ресторан.
Ссылка – страница этого объекта на конкретной площадке. Ссылок обычно несколько, по одной на площадку.
Отзыв привязан к ссылке и площадке внутри объекта.
Отзывы читаются на уровне объекта: GET /v2/reviews?group_id=….
Папка – необязательный уровень выше
Если объектов много, их можно сложить в папки и запрашивать данные сразу по набору:
GET /v2/reviews?folder_id=…. Максимальная глубина: два уровня. Один объект может лежать
в нескольких папках.
Отзывы при этом живут в объекте: папка только адресует запрос. Подробности в руководстве.
Ответ – ваш, а не любой
У отзыва бывает ответ организации: он приходит в полях reply_text и reply_date и собирается
с площадки как есть, кем бы он ни был написан.
Ответ, который вы публикуете через нас, – это то же самое место на площадке,
только заполненное вами: после публикации он приходит в тех же reply_text и reply_date.
Ответ у отзыва ровно один, и место под него на площадке одно.
Оценки приведены к 1–5
Площадки считают по-разному: пять баллов, десять, сто, «палец вверх».
Rewio приводит всё к шкале 1–5. Это поле rating, оно может быть дробным. Исходная оценка
площадки остаётся рядом, в rating_original. У площадок без числовой оценки rating пустой.
Площадки
GET /v2/sources отдаёт справочник площадок: числовой id, машинное
имя name, отображаемое display_name и возможности: поддерживает ли площадка ответы
организации, бывают ли фотографии, какая у неё исходная шкала.
По id фильтруют отзывы и аналитику (source_ids), машинное name используется в фильтрах
вебхуков (allowed_sources).