/api/lite/pub/products/reviews

Получение отзывов

/api/lite/pub/products/reviews

Возвращает подтвержденные отзывы на товары. Отзывы отсортированы по дате создания, начиная с новых.

?productId=1030  - обязательный параметр для фильтрации по идентификатору товара

Пейджинация

Для пейджинации используются параметры page и size: size - отзывов на странице, page - номер страницы.

Пример: /api/lite/pub/products/reviews?page=0&size=200

Если параметры не переданы, то дефолтные значения page=0&size=100

Также, для отображение пейджинации следует анализировать параметр recordsTotal, возвращающий общее количество записей (с учетом примененной фильтрации, если она есть).

Поле

Тип / формат

Описание

id

string

Идентификатор отзыва.

product

object

Информация о товаре

  id

string

Идентификатор товара

  shortName

string

Название товара

  images

array

Изображения товара

     url

string

Ссылка на изображение

     id

string

Имя файла

     pos

double

Позиция

createTs

datetime

Время создания отзыва

customerName

string

Имя автора отзыва

content

string

Текст отзыва

score

decimal

Оценка (от 1 до 5)

status

enum

Статус отзыва

CONFIRMED

Пример результата запроса:

{

 "success": true,

 "recordsTotal": 1,

 "reviews": [

 {

 "id": "e7951e18-8ee3-61b2-b616-018331a8fb06",

 "product": {

 "id": "1030",

 "shortName": "Масло для бороды Бунтарь - Дамаск",

 "images": [

 {

 "url": "https://storage.yandexcloud.net/images-k2c/aff3c7f1-8b7c-47ea-a3a9-e9a52e476c12.jpg",

 "id": "aff3c7f1-8b7c-47ea-a3a9-e9a52e476c12.jpg",

 "pos": "10000.000000000000000"

 }

 ]

 },

 "createTs": "2020-08-07 19:35:36",

 "customerName": "Петя",

 "content": "текст отзыва",

 "score": 5,

 "status": "CONFIRMED"

 }

 ]

}

Создание отзывов

/api/lite/pub/products/reviews

Добавляет новый отзыв.

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

{

 "productId": "1030",

	"customerName": "Петя",

	"content": "текст отзыва",

	"score": 5

}

В ответ возвращается

Успех:

{

 "success": true,

 "review": {

 "id": "6c62461f-fcf4-c388-c3b4-e09971590d6b",

 "product": {

 "id": "1030",

 	"shortName": "Масло для бороды Бунтарь - Дамаск",

 	"images": [

 {

 "url": "https://storage.yandexcloud.net/images-k2c/aff3c7f1-8b7c-47ea-a3a9-e9a52e476c12.jpg",

 "id": "aff3c7f1-8b7c-47ea-a3a9-e9a52e476c12.jpg",

 "pos": "10000.000000000000000"

 }

 ]

 },

 "createTs": "2020-08-07 18:53:46",

 "customerName": "Петя",

 "content": "текст отзыва",

 "score": 5,

 "status": "NEW"

 }

}

Ошибка:

{

 "success": false,

 "errors": [

 {

 "code": 0,

 "message": "Текст ошибки"

 }

 ]

}