Модель данных

Всё в Rewio держится на трёх сущностях: объект, ссылка, отзыв.

Объект «Гранд Отель»  (object_id: 20)
├── Ссылка → Яндекс Карты   (link_id: 181, source_id: 1)  →  отзывы…
├── Ссылка → 2ГИС           (link_id: 182, source_id: 3)  →  отзывы…
└── Ссылка → Otzovik        (link_id: 183, source_id: 202) →  отзывы…

Объект – ваша конкретная бизнес-сущность: один отель, одна клиника, один врач, один ресторан.

Ссылка – страница этого объекта на конкретной площадке. Обычно у объекта несколько ссылок, по одной на каждую площадку.

Отзыв привязан к ссылке и площадке внутри объекта.

Папка – необязательный уровень выше

Если объектов много, их можно сложить в папки и запрашивать данные сразу по набору: GET /v3/reviews?folder_id=…. Максимальная глубина: два уровня. Один объект может лежать в нескольких папках.

Отзывы при этом живут в объекте: папка только адресует запрос. Подробности в руководстве.

Ответ на отзыв

У отзыва бывает ответ организации: он приходит в полях reply_text и reply_date и собирается с площадки как есть, кем бы он ни был написан.

Ответ, который вы публикуете через нас, – это то же самое место на площадке, только заполненное вами: после публикации он приходит в тех же reply_text и reply_date. Ответ у отзыва ровно один, и место под него на площадке одно.

Оценки приведены к 1–5

Площадки считают по-разному: пять баллов, десять, сто, «палец вверх».

Rewio приводит всё к шкале 1–5. Это поле rating, оно может быть дробным. Исходная оценка площадки остаётся рядом, в rating_original. У площадок без числовой оценки rating пустой.

Площадки

GET /v3/sources отдаёт справочник площадок: числовой id, машинное имя slug, название для показа name и возможности: поддерживает ли площадка ответы организации, бывают ли фотографии, какая у неё исходная шкала.

По id фильтруют отзывы и аналитику (source_ids), slug используется в фильтрах вебхуков (allowed_sources).