# Логи веб-хуков

**Лог веб-хуков** – это подробная история обмена данными, фиксирующая время запроса, его содержимое и ответ сервера. Без этих данных поддержка интеграции превращается в поиск ошибок вслепую.

Логи помогают решить следующие основные задачи:

<span style="font-family: Wingdings; mso-fareast-font-family: Wingdings; mso-bidi-font-family: Wingdings;"><span style="mso-list: Ignore;">&#159;<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>отладка – на этапе настройки разработчик сразу видит корректность передачи данных;

<span style="font-family: Wingdings; mso-fareast-font-family: Wingdings; mso-bidi-font-family: Wingdings;"><span style="mso-list: Ignore;">&#159;<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>контроль доставки – если ваш сервер станет недоступен, логи зафиксируют тип ошибки (404, 502, timeout);

<span style="font-family: Wingdings; mso-fareast-font-family: Wingdings; mso-bidi-font-family: Wingdings;"><span style="mso-list: Ignore;">&#159;<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>автоматизация возврата – видя сбой в логах, система лояльности сама инициируют повторные попытки, пока данные не будут доставлены.

### Список логов веб-хуков

Для просмотра и работы со списком логов, необходимо перейти в раздел **События** - **Логи веб-хуков**

**[![26.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-03/scaled-1680-/26.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-03/26.png)**

<span style="mso-bidi-font-weight: bold;">На текущей закладке отображается список логов веб‑хуков и набор инструментов для работы со списком:</span>

<span style="font-family: Wingdings; mso-fareast-font-family: Wingdings; mso-bidi-font-family: Wingdings;"><span style="mso-list: Ignore;">&#159;<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>**Поисковая строка** – обеспечивает поиск необходимого лога веб-хука;

<span style="font-family: Wingdings; mso-fareast-font-family: Wingdings; mso-bidi-font-family: Wingdings;"><span style="mso-list: Ignore;">&#159;<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>**Фильтры** – позволяет проводить поиск логов по определенным критериям. Доступны фильтры:

<span style="font-family: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol;"><span style="mso-list: Ignore;">-<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>**Начало периода**;

<span style="font-family: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol;"><span style="mso-list: Ignore;">-<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>**Конец периода**;

<span style="font-family: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol;"><span style="mso-list: Ignore;">-<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>**Фильтр по ошибкам**;

<span style="font-family: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol;"><span style="mso-list: Ignore;">-<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>**Поиск по идентификатору хука**;

<span style="font-family: Wingdings; mso-fareast-font-family: Wingdings; mso-bidi-font-family: Wingdings;"><span style="mso-list: Ignore;">&#159;<span style="font: 7.0pt 'Times New Roman';"> [![21.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-03/scaled-1680-/21.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-03/21.png)</span></span></span> – позволяет просмотреть информацию о логе веб‑хука;

<span style="font-family: Wingdings; mso-fareast-font-family: Wingdings; mso-bidi-font-family: Wingdings;"><span style="mso-list: Ignore;">&#159;<span style="font: 7.0pt 'Times New Roman';"> [![22.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-03/scaled-1680-/22.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-03/22.png) </span></span></span>– удаляет веб-хук.

### Взаимосвязь

Логику работы системы можно представить как цепочку:

<span style="mso-fareast-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">1.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Действие – покупатель сканирует карту на кассе.

<span style="mso-fareast-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">2.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Событие – в базе данных системы лояльности фиксируется запись.

<span style="mso-fareast-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">3.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Формирование веб-хука – система лояльности видит, что на событие подписан адрес (URL) вашего сервера или CRM. Она берет данные (ID клиента, сумму, количество баллов) и упаковывает их в JSON-пакет.

<span style="mso-fareast-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">4.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Отправка – система лояльности «стучится» на ваш сервер.

<span style="mso-fareast-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">5.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Логирование – факт отправки и ответ вашего сервера записываются в логи.

Техническая связь с сервером происходит по протоколу HTTP (обычно через метод POST). На стороне системы управления лояльностью настраивается URL-эндпоинт (адрес, куда слать данные) и типы событий.

На стороне вашего сервера должен быть написан небольшой скрипт (обработчик), который:

<span style="mso-fareast-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">1.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Принимает входящий запрос.

<span style="mso-fareast-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">2.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Проверяет его подлинность (например, через секретный ключ или токен).

<span style="mso-fareast-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">3.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Отдает ответ 200 OK (подтверждение получения).

<span style="mso-fareast-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">4.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Запускает дальнейшую логику (например, обновляет баланс в мобильном приложении).