Модерация отзывов

Раздел описывает методы для модерации отзывов на стороне магазина. Если вам достаточно модерации в личном кабинете («Опросы и формы → Отзывы о товарах → Отчет»), эти методы не нужны.

Напомним статусы отзыва:

Статус	Описание
moderation	Отзыв ожидает модерации. Начальный статус любого нового отзыва
published	Отзыв опубликован и отдается в методе reviews/product
rejected	Отзыв отклонен и нигде не публикуется

Переходы между статусами:

stateDiagram-v2
    [*] --> moderation
    moderation --> published : reviews/publish
    moderation --> rejected : reviews/reject
    published --> rejected : reviews/reject
    rejected --> published : reviews/publish
    published --> moderation : reviews/moderate
    rejected --> moderation : reviews/moderate

Попытка выполнить переход, которого нет на схеме — например, опубликовать уже опубликованный отзыв — вернет ошибку 400.

Все методы раздела требуют shop_id и shop_secret.

Отзывы, ожидающие модерации

Метод возвращает отзывы в статусе moderation со всеми данными, включая идентификаторы клиента.

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

Параметры

Параметр	Тип	Обязателен?	Описание
shop_id	String	Да	API-ключ
shop_secret	String	Да	Секретный API-ключ
product	String	Нет	Отзывы только об этом товаре
date_from	String	Нет	Дата начала периода выборки в формате YYYY-MM-DD
date_to	String	Нет	Дата окончания периода выборки в формате YYYY-MM-DD
limit	Integer	Нет	Сколько отзывов вернуть. По умолчанию 100, максимум 1000
offset	Integer	Нет	Сколько отзывов пропустить. По умолчанию 0

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

Отзывы на модерации отдаются вместе с email и телефоном клиента, поэтому по умолчанию метод возвращает 100 записей. Поднимайте limit до 1000 только если действительно обрабатываете такие объемы.

Запрос

curl "https://api.rees46.ru/reviews/pending?shop_id=...&shop_secret=...&date_from=2026-10-01&date_to=2026-10-07"

Ответ

{
  "status": "success",
  "payload": {
    "reviews": [
      {
        "id": 1,
        "product": "SKU-1024",
        "order": "ORDER-3341",
        "rating": 5,
        "comment": "Отличная кофемолка",
        "state": "moderation",
        "client": 1515915625535836508,
        "email": "example@test.com",
        "phone": "79876543210",
        "created_at": "2026-10-07T02:35:06.374Z"
      }
    ]
  }
}

Расшифровка свойств отзыва — в описании метода reviews/create. Отзывы отсортированы от старых к новым, чтобы модерировать их в порядке поступления.

Если отзывов на модерации нет, в reviews придет пустой массив.

Публикация отзыва

POST https://api.rees46.ru/reviews/publish

Отклонение отзыва

POST https://api.rees46.ru/reviews/reject

Возврат на модерацию

POST https://api.rees46.ru/reviews/moderate

Параметры

У всех трех методов параметры одинаковые. Отзыв адресуется либо своим идентификатором review_id, либо тройкой «товар + заказ + клиент».

Параметр	Тип	Обязателен?	Описание
shop_id	String	Да	API-ключ
shop_secret	String	Да	Секретный API-ключ
review_id	Integer	Нет	Идентификатор отзыва. Если передан, остальные параметры адресации не нужны
product	String	Нет	Идентификатор товара в вашем каталоге
order	String	Нет	Идентификатор заказа в вашей системе
email*	String	Нет	Email клиента
phone*	String	Нет	Телефон клиента
loyalty_id*	String	Нет	Идентификатор участника программы лояльности
external_id*	String	Нет	Внешний идентификатор клиента
telegram_id*	String	Нет	Идентификатор клиента в Telegram

Адресация отзыва

Если review_id не передан, нужны product, order и хотя бы один идентификатор клиента [*].

Запрос

curl 'https://api.rees46.ru/reviews/publish' \
    -X 'POST' \
    -H 'Content-Type: application/json' \
    --data-raw '{"shop_id":"SHOP_ID", "shop_secret":"SHOP_SECRET", "review_id":1}'

Ответ

{
  "status": "success",
  "payload": {
    "review": {
      "id": 1,
      "product": "SKU-1024",
      "order": "ORDER-3341",
      "rating": 5,
      "comment": "Отличная кофемолка",
      "state": "published",
      "client": 1515915625535836508,
      "email": "example@test.com",
      "phone": "79876543210",
      "created_at": "2026-10-07T02:35:06.374Z"
    }
  }
}

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

Код	Сообщение	Причина
400	Missing user identifier	Отзыв адресуется без review_id и без идентификатора клиента
400	текст ошибки перехода статуса	Такого перехода статуса нет. Например, публикация опубликованного отзыва
403	Invalid API key or secret key	Не передан или неверен shop_secret
403	Service is not enabled	Услуга отзывов о товарах не подключена в тарифе
404	Product not found	Товара с таким product нет в каталоге
404	Order not found	Заказа с таким order нет в платформе
404	Review not found	Отзыв по переданным параметрам не найден