# Отзывы

## Получение списка

<mark style="color:blue;">`GET`</mark> `https://api.waix.ru/site/opinion`

Список будет сформирован от более новых к более старым, по умолчанию выводится 20 записей, но вы можете запросить любое число от 1 до 100. Содержание текста одной записи будет сокращено до 20 слов, вы так же можете указать сокращение содержания слов от 10 до 100. Значение `words=0` отключает вывод содержимого записи. Все html теги в содержании будут удалены или отредактированы

#### Query Parameters

| Name                                                      | Type   | Description                                                                                                                               |
| --------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| token or key or project<mark style="color:red;">\*</mark> | String | Серверный или клиентский [токен](/access.md#klyuch-token), [ключ-доступа](/access.md#klyuch-kod) или номер [проекта](/expand/projects.md) |
| count                                                     | int    | количество записей 20 или любое другое число                                                                                              |
| offset                                                    | int    | Выводит записи с отступом (т.е кроме n первых записей)                                                                                    |
| words                                                     | int    | Указывает сколько слов должно содержаться в кратком выводе содержимого текста. Допустимо от нуля до 100 слов                              |

{% tabs %}
{% tab title="200: OK Выводится список" %}

<pre class="language-json" data-overflow="wrap"><code class="lang-json"><strong>{
</strong>  "status": "OK",
  "result": [
    {
      "id": 7438,
      "order_id": 0,
      "author": "Александр",
      "content": "Я хотел бы поделиться положительным опытом сотрудничества с транспортной компанией Посредник №1. С момента первой консультации я был приятно удивлён профессионализмом...",
      "comment": null,
      "rating": null,
      "images": [
        "https://d.zaix.ru/PiuG.jpeg",
        "https://d.zaix.ru/PiuH.jpeg",
        "https://d.zaix.ru/PiuI.jpeg"
      ],
      "created": 1752865524,
      "date": "30 сен 2025",
      "user": {
        "name": "Александр",
        "avatar": null,
        "vip": 0
      }
    },
    {
      "id": 7437,
      "order_id": 0,
      "author": "Дмитрий Фурс",
      "content": "Как всегда всё хорошо. Товар доставлен в целости и сохранности. Спасибо за оперативный сбор товара и отправки его в пункт...",
      "comment": null,
    },
    ...
  ],
  "total": 2803
}
</code></pre>

{% endtab %}
{% endtabs %}

## Получение детального содержимого

<mark style="color:blue;">`GET`</mark> `https://api.waix.ru/site/opinion/{id}`

Ответ будет содержать отзыв «как есть», с выборочным сохранением тегов:

```html
<br> <b> <i> <u> <a> <strong> <em> <span>
```

#### Любые стили внутри тегов будут удалены перед выдачей, но по прежнему сохранены в системе

#### Path - /параметр/параметр

| Name                                 | Type | Description                                 |
| ------------------------------------ | ---- | ------------------------------------------- |
| id<mark style="color:red;">\*</mark> | Int  | Идентификатор из [списка](/site/opinion.md) |

#### Query — (параметр=значение)

| Name                                                      | Type   | Description                                                                                                                               |
| --------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| token or key or project<mark style="color:red;">\*</mark> | String | Серверный или клиентский [токен](/access.md#klyuch-token), [ключ-доступа](/access.md#klyuch-kod) или номер [проекта](/expand/projects.md) |

{% tabs %}
{% tab title="200: OK Выводится содержимое" %}
{% code overflow="wrap" %}

```json
{
    "status": "OK",
    "result": {
        "content": "Я хотел бы поделиться положительным опытом сотрудничества с транспортной компанией Посредник №1. С момента первой консультации я был приятно удивлён профессионализмом менеджеров — они были готовы ответить на все вопросы и предоставить подробную информацию о процессе доставки. Оплата прошла быстро и без проблем, а сама доставка оказалась значительно быстрее, чем я ожидал, что было отличным сюрпризом. Цены очень конкурентоспособные, что делает сотрудничество с вами ещё более выгодным. Сайт компании интуитивно понятен и удобен для использования, что упрощает процесс оформления заказа. Я уже совершил несколько заказов, и каждый раз упаковка была на высшем уровне — всё было аккуратно упаковано и пришло в идеальном состоянии.",
        "comment": null,
        "created": 1752865524,
        "date": "30 сен 2025",
        "user": null,
        "images": [],
        "author": null
    }
}  
```

{% endcode %}
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.waix.ru/site/opinion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
