# /api/lite/products/reviews

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

/api/lite/products/reviews

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

#### **Фильтрация**

`?productId=1030` - для фильтрации по идентификатору товара

`?status=NEW` - для фильтрации по статусу отзыва

#### **Пейджинация**

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

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

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

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

<div id="bkmrk-"><svg class="svg-icon" data-icon="link" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg></div><div id="bkmrk-%D0%9F%D0%BE%D0%BB%D0%B5-%D0%A2%D0%B8%D0%BF-%2F-%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82-%D0%9E%D0%BF"><table class="relative-table wrapped confluenceTable tablesorter tablesorter-default" role="grid" style="width: 91.4581%;"><tbody aria-live="polite" aria-relevant="all"><tr><td style="width: 33.3333%;">**Поле**</td><td style="width: 33.3333%;">**Тип / формат**</td><td style="width: 40.2597%;">**Описание**</td></tr><tr role="row"><td class="confluenceTd" style="width: 33.3333%;">id</td><td class="confluenceTd" style="width: 33.3333%;">string</td><td class="confluenceTd" style="width: 40.2597%;">Идентификатор отзыва. </td></tr><tr role="row" style="height: 29px;"><td class="confluenceTd" style="width: 33.3333%; height: 29px;">**product**</td><td class="confluenceTd" style="width: 33.3333%; height: 29px;">**object**</td><td class="confluenceTd" style="width: 40.2597%; height: 29px;">**Информация о товаре**</td></tr><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;"> id</td><td style="width: 33.3333%; height: 29px;">string</td><td style="width: 40.2597%; height: 29px;">Идентификатор товара</td></tr><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;"> shortName</td><td style="width: 33.3333%; height: 29px;">string</td><td style="width: 40.2597%; height: 29px;">Название товара</td></tr><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;"> **images**</td><td style="width: 33.3333%; height: 29px;">**array**</td><td style="width: 40.2597%; height: 29px;">**Изображения товара**</td></tr><tr><td style="width: 33.3333%;"> url</td><td style="width: 33.3333%;">string</td><td style="width: 40.2597%;">Ссылка на изображение</td></tr><tr><td style="width: 33.3333%;"> id</td><td style="width: 33.3333%;">string</td><td style="width: 40.2597%;">Имя файла</td></tr><tr><td style="width: 33.3333%;"> pos</td><td style="width: 33.3333%;">double</td><td style="width: 40.2597%;">Позиция</td></tr><tr role="row"><td class="confluenceTd" style="width: 33.3333%;">createTs</td><td class="confluenceTd" style="width: 33.3333%;">datetime</td><td class="confluenceTd" style="width: 40.2597%;">Время создания отзыва</td></tr><tr role="row"><td class="confluenceTd" style="width: 33.3333%;">customerName</td><td class="confluenceTd" style="width: 33.3333%;">string</td><td class="confluenceTd" style="width: 40.2597%;">Имя автора отзыва

</td></tr><tr><td style="width: 33.3333%;">content</td><td style="width: 33.3333%;">string</td><td style="width: 40.2597%;">Текст отзыва

</td></tr><tr><td style="width: 33.3333%;">score</td><td style="width: 33.3333%;">decimal</td><td style="width: 40.2597%;">Оценка (от 1 до 5)

</td></tr><tr><td style="width: 33.3333%;">status</td><td style="width: 33.3333%;">enum</td><td style="width: 40.2597%;">Статус отзыва

- NEW
- CONFIRMED
- DELETED

</td></tr></tbody></table>

</div>#### **Пример результата запроса:**

```JSON
{
    "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": "NEW"
        }
    ]
}
```

### Редактирование отзывов

/api/lite/products/reviews

Редактирует отзыв.

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

```JSON
{
    "id": "6c62461f-fcf4-c388-c3b4-e09971590d6b",
	"customerName": "Петя",
	"content": "текст отзыва",
	"status": "CONFIRMED"
}
```

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

#### **Успех:**

```JSON
{
    "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": "CONFIRMED"
    }
}
```

#### **Ошибка:**

```JSON
{
    "success": false,
    "errors": [
        {
            "code": 0,
            "message": "Текст ошибки"
        }
    ]
}
```