Интеграция с ReviewLab по API

Возможности API

С помощью API ReviewLab вы можете:

Получать данные по виджету
Получать список отзывов из конкретного виджета

Начало работы

Чтобы начать работать с API ReviewLab:

Зарегистрируйтесь в личном кабинете
Создайте виджет и добавьте в него ссылки на филиалы, откуда нужно собирать отзывы

Получение данных по виджету

Формат запроса

GET https://app.reviewlab.ru/api/v1/widgets/widget/:widgetId/reviews/remote

Где widgetId — идентификатор виджета, который доступен в адресной строке браузера на странице виджета.

Запрос возвращает список отзывов виджета с поддержкой пагинации и фильтрации.

Параметры запроса

Path параметры:

Параметр	Тип	Обязательный	Описание
widgetId	string	Да	Идентификатор виджета

Query параметры:

Параметр	Тип	Обязательный	Описание
limit	number	Да	Количество отзывов для загрузки. Максимум: 300. Пример: ?limit=50
skip	number	Нет	Количество отзывов для пропуска (пагинация). По умолчанию: 0. Пример: ?skip=50&limit=50
type	string	Нет	Фильтрация отзывов по платформе. Возможные значения: doubleGis, yaSprav, avito, zoon, vkontakte, prodoctorov, otzovik, googleMap, yaBusiness

Примеры запросов

# Первые 20 отзывов
GET /api/v1/widgets/widget/abc123/reviews/remote?limit=20

# Вторая страница (отзывы 20-40)
GET /api/v1/widgets/widget/abc123/reviews/remote?skip=20&limit=20

# Только отзывы с Авито
GET /api/v1/widgets/widget/abc123/reviews/remote?limit=20&type=avito

Формат ответа

[
  {
    "_id": "string",
    "name": "string",
    "photo": "string",
    "message": "string",
    "images": ["string"],
    "rating": "number",
    "date": "Date",
    "src": "string",
    "type": "string"  // "doubleGis" | "yaSprav" | "avito" | "zoon" | "vkontakte" | "prodoctorov" | "otzovik" | "googleMap" | "yaBusiness"
  }
]

Пагинация

Для постраничной загрузки используйте комбинацию параметров skip и limit:

// Страница 1
fetch('/api/v1/widgets/widget/abc123/reviews/remote?limit=20&skip=0')

// Страница 2
fetch('/api/v1/widgets/widget/abc123/reviews/remote?limit=20&skip=20')

// Страница 3
fetch('/api/v1/widgets/widget/abc123/reviews/remote?limit=20&skip=40')

Ограничения

Максимум 300 отзывов за один запрос
При превышении лимита API вернет 400 Bad Request