Отзывы о товаре

Метод возвращает опубликованные отзывы о товаре и сводную оценку по нему. Используется на карточке товара.

Это единственный публичный метод раздела: он требует только shop_id, секретный ключ передавать не нужно. Отзывы в статусах moderation и rejected в выдачу не попадают.

GET https://api.rees46.ru/reviews/product

Параметры

Параметр	Тип	Обязателен?	Описание
shop_id	String	Да	API-ключ
product	String	Да	Идентификатор товара в вашем каталоге
limit	Integer	Нет	Сколько отзывов вернуть. По умолчанию 20, максимум 100
offset	Integer	Нет	Сколько отзывов пропустить. По умолчанию 0

Сводка не зависит от пагинации

summary всегда считается по всем опубликованным отзывам товара, а limit и offset влияют только на массив reviews. Поэтому для построения блока «4.3 из 5, 42 отзыва» достаточно одного запроса.

Запрос

Пример запроса:

curl "https://api.rees46.ru/reviews/product?shop_id=...&product=SKU-1024&limit=20&offset=0"

Ответ

Пример ответа сервера:

{
  "status": "success",
  "payload": {
    "summary": {
      "count": 42,
      "average_rating": 4.3,
      "ratings": {
        "1": 1,
        "2": 2,
        "3": 5,
        "4": 12,
        "5": 22
      }
    },
    "reviews": [
      {
        "id": 128,
        "rating": 5,
        "comment": "Отличная кофемолка",
        "author": "Иван",
        "created_at": "2026-10-07T02:35:06.374Z"
      },
      {
        "id": 127,
        "rating": 4,
        "comment": null,
        "author": null,
        "created_at": "2026-10-06T19:12:44.102Z"
      }
    ]
  }
}

Расшифровка сводки:

Свойство	Тип	Описание
summary.count	Integer	Количество опубликованных отзывов о товаре
summary.average_rating	Float	Средняя оценка, округленная до 0.1. null, если отзывов нет
summary.ratings	Object	Количество отзывов по каждой оценке от 1 до 5

Расшифровка свойств отзыва:

Свойство	Тип	Описание
id	Integer	Идентификатор отзыва
rating	Integer	Оценка: 1..5
comment	String	Текст отзыва, null если клиент оставил только оценку
author	String	Имя автора из CDP, null если имя неизвестно
created_at	String	Дата и время отзыва

Отзывы отсортированы от новых к старым.

Персональные данные

В публичном методе отдается только имя автора. Email, телефон и идентификатор клиента доступны в методах, требующих секретного ключа: reviews/pending и reviews/create.

Если у товара нет опубликованных отзывов, reviews придет пустым массивом, count будет 0, а average_rating — null:

{
  "status": "success",
  "payload": {
    "summary": {
      "count": 0,
      "average_rating": null,
      "ratings": { "1": 0, "2": 0, "3": 0, "4": 0, "5": 0 }
    },
    "reviews": []
  }
}

Возможные ошибки:

Код	Сообщение	Причина
403	Service is not enabled	Услуга отзывов о товарах не подключена в тарифе
404	Product not found	Товара с таким product нет в каталоге