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

Всё в 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 и собирается с площадки как есть, кем бы он ни был написан.

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

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

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

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

Площадки

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

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