Skip to main content

Обзор

Бот предоставляет две системы для real-time обновлений:
  1. WebSocket — для real-time обновлений в веб-админке
  2. Webhooks — для отправки событий во внешние системы

WebSocket

Подключение

WebSocket endpoint: ws://your-api-host:port/ws Авторизация через query-параметр:

Формат сообщений

Подтверждение подключения:
Событие:
Keepalive (ping/pong):

Поддерживаемые события

Webhooks

Создание webhook

Поддерживаемые события

  • user.created — создан новый пользователь
  • payment.completed — завершён платёж
  • transaction.created — создана транзакция
  • ticket.created — создан тикет
  • ticket.status_changed — изменён статус тикета

Заголовки запроса

Подпись payload

Если при создании webhook указан secret, payload подписывается HMAC-SHA256:

API эндпоинты

Статусы доставки

  • pending — ожидает отправки
  • success — успешно доставлен (HTTP 200-299)
  • failed — ошибка доставки

Безопасность

  1. WebSocket: Требует валидный API токен
  2. Webhooks: Используйте HTTPS, подписывайте payload через secret, проверяйте подпись на стороне получателя