Все методы
Весь API целиком, одной страницей. Адрес https://api.rewio.ru, префикс /v3, ключ в заголовке
X-API-Key у каждого запроса. Название метода ведёт на его страницу с параметрами,
полями ответа и живым примером.
Отзывы и аналитика
| Метод | Что делает |
|---|---|
GET /v3/sources | Справочник площадок: id, машинное имя, шкала оценок, что площадка умеет. |
GET /v3/reviews | Отзывы объекта или папки: фильтры по оценке, дате, площадке и тексту, сортировка, страницы. |
GET /v3/reviews/{review_id} | Один отзыв по идентификатору – та же модель, что в ленте. |
GET /v3/reviews/sync | Поток изменений с курсором – чтобы держать у себя актуальную копию отзывов. |
GET /v3/analytics | Сводка по объекту или папке: средняя оценка, распределение, полнота и скорость ответов. |
GET /v3/analytics/timeseries | Те же метрики по дням, неделям или месяцам. |
Объекты и площадки
Объект – ваш объект учёта (отель, клиника, филиал, врач). Ссылка – его страница на конкретной площадке.
| Метод | Что делает |
|---|---|
POST /v3/objects | Создать объект, сразу со ссылками на площадки. |
GET /v3/objects | Список объектов со ссылками и состоянием сбора. |
GET /v3/objects/{object_id} | Один объект со всеми его ссылками. |
PUT /v3/objects/{object_id} | Переименовать объект, включить или выключить сбор. |
PUT /v3/objects | Массовый выключатель сразу для набора объектов. |
DELETE /v3/objects/{object_id} | Удалить объект вместе с его ссылками. |
POST /v3/objects/{object_id}/links | Подключить к объекту новые площадки. |
GET /v3/objects/{object_id}/links | Ссылки объекта и состояние сбора по каждой. |
PUT /v3/objects/{object_id}/links/{link_id} | Переименовать ссылку или остановить сбор по ней. |
DELETE /v3/objects/{object_id}/links/{link_id} | Отключить площадку от объекта. |
Папки
Уровень выше: набор объектов, по которому можно спросить отзывы и
аналитику одним параметром folder_id.
| Метод | Что делает |
|---|---|
POST /v3/folders | Создать папку и положить в неё объекты. |
GET /v3/folders | Все папки с подпапками и составом. |
GET /v3/folders/{folder_id} | Одна папка со своими объектами и подпапками. |
PATCH /v3/folders/{folder_id} | Переименовать, перенести или заменить состав. |
DELETE /v3/folders/{folder_id} | Удалить папку, не трогая объекты внутри. |
Ответы на отзывы
Ответ публикуется под отзывом на самой площадке. Включается по запросу – напишите на
info@rewio.ru; нужен полный тариф и ключ full. Подробности –
в руководстве «Как отвечать на отзывы».
| Метод | Что делает |
|---|---|
PUT /v3/reviews/{review_id}/reply | Опубликовать ответ или заменить уже стоящий. |
DELETE /v3/reviews/{review_id}/reply | Удалить ваш ответ с площадки. |
Вебхуки
| Метод | Что делает |
|---|---|
POST /v3/webhooks | Получать новые отзывы и ответы пушем на свой адрес. |
GET /v3/webhooks | Все вебхуки аккаунта и состояние доставки. |
PATCH /v3/webhooks/{webhook_id} | Поменять адрес, объекты и фильтры или поставить на паузу. |
DELETE /v3/webhooks/{webhook_id} | Отключить доставку. |
POST /v3/webhooks/{webhook_id}/test | Пробное событие с настоящей подписью. |
GET /v3/webhooks/secret | Ключ, которым подписаны все доставки аккаунта. |
POST /v3/webhooks/rotate-secret | Заменить ключ подписи, не теряя доставок. |
Для виджетов
Скрыть неудачный отзыв и закрепить удачный. Действует на выдачу, а не на данные: исходные отзывы остаются как есть.
| Метод | Что делает |
|---|---|
POST /v3/objects/{object_id}/hidden-reviews | Убрать отзывы из ленты этого объекта. |
GET /v3/objects/{object_id}/hidden-reviews | Что сейчас скрыто. |
DELETE /v3/objects/{object_id}/hidden-reviews | Вернуть отзывы в ленту. |
POST /v3/objects/{object_id}/pinned-reviews | Закрепить отзывы наверху списка. |
GET /v3/objects/{object_id}/pinned-reviews | Что закреплено и в каком порядке. |
PUT /v3/objects/{object_id}/pinned-reviews | Заменить список закреплённых целиком. |
DELETE /v3/objects/{object_id}/pinned-reviews | Открепить, оставив отзывы в ленте. |
Дополнительно
| Метод | Что делает |
|---|---|
POST /v3/support/message | Написать разработчику. Работает с любым ключом, включая read_only. |
Без ключа
| Метод | Что делает |
|---|---|
GET /health | API на связи. |
GET /health/read | Чтение работает – методы отзывов и аналитики ответят. Иначе 503. |
Ключи и доступ описаны в отдельном разделе, формат ошибок – в Ошибках, а что такое объект и ссылка – в Модели данных.