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

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

curl "https://api.rewio.ru/v2/reviews?group_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.

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

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

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

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

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

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