Ключи и доступ

Каждый запрос содержит ключ в заголовке X-API-Key:

curl "https://api.rewio.ru/v3/reviews?object_id=20" \
  -H "X-API-Key: hrev_ВАШ_КЛЮЧ"

Ключи начинаются с hrev_. Запрос без ключа или с неверным получает 401 с кодом unauthorized.

Два уровня доступа

Скоуп	Что можно	Для чего
`read_only`	Только чтение: отзывы, аналитика, списки объектов, ссылок и площадок.	Серверная выдача отзывов и интеграции, которым нужно только читать.
`full`	Чтение и запись: создавать и менять объекты, ссылки, вебхуки.	Серверная интеграция с полным доступом.

Собственные ключи (full/read_only) рекомендуем хранить только на своём сервере: read_only тоже раскрывает ваши данные на чтение, хотя и запрещает любые изменения.

Чтобы показать отзывы на публичном сайте, обращайтесь к Rewio со своего бэкенда, а браузеру отдавайте уже готовый ответ.

Тестовый ключ

Только на чтение и только по демо-данным. Им работают примеры на этих страницах и кнопка «Отправить запрос»:

hrev_FaDGMKJEDDeCR5BCBgEg0aEjMogI7O7hOzE53YY4T1M

Где взять боевой ключ

В личном кабинете app.rewio.ru. После регистрации аккаунт сразу получает два ключа – Full и Read-only. Там же можно создать дополнительные, посмотреть значение выданного и отозвать ненужный.

Остались вопросы по подключению – напишите: info@rewio.ru.

Пробный доступ

После регистрации аккаунт работает бесплатно 21 день. В это время действуют два ограничения:

Что	Сколько на пробном доступе	После оплаты
Объектов	30	Сколько оплачено
Отзывов в выдаче	20 самых свежих по каждой площадке	Все собранные

Отзывы при этом собираются полностью — ограничена только выдача. Оплата открывает накопленное сразу, пересобирать ничего не нужно.

Когда окно действует, ответ методов отзывов и аналитики содержит блок access:

{
  "data": [ /* ... */ ],
  "total": 25,
  "access": {
    "reason": "trial",
    "limit_per_link": 20,
    "hidden_total": 204,
    "message": "Пробный доступ показывает 20 самых свежих отзывов по каждой площадке. Ещё 204 отзыва уже собрано — они откроются сразу после оплаты."
  }
}

hidden_total – сколько отзывов уже собрано сверх окна. Блока access нет вовсе, если ограничения нет: его отсутствие и означает полный доступ.

Окно считается до фильтров и сортировки. sort_order=asc или фильтр по рейтингу работают внутри двадцати последних, а не выбирают другие двадцать из архива.

Версии API

Актуальная версия — /v3, она описана на этих страницах. Полная схема: api.rewio.ru/openapi.json.

/v1 закрыт: он отвечает только интеграциям, написанным до закрытия, и отдаёт им Deprecation в заголовках. Новый ключ на /v1 получит 410 с кодом api_version_gone. /v2 остаётся рабочим и описан отдельно — переходить на /v3 можно постепенно, но новые интеграции пишите сразу на /v3.

Проверка доступности

Два метода работают без ключа:

Метод	Ответ	Что означает
`GET /health`	`{"status": "healthy"}`	API на связи.
`GET /health/read`	`{"status": "ready"}`, иначе `503`	Чтение работает, методы отзывов и аналитики ответят.

curl https://api.rewio.ru/health
curl https://api.rewio.ru/health/read

Как не опрашивать нас в цикле

Отзывы обновляются по расписанию, поэтому тесный цикл запросов ничего не ускоряет. Чтобы узнавать о новых отзывах и ответах, подпишитесь на вебхуки – мы пришлём событие сами – или используйте синхронизацию данных через курсор.