Event Webhooks

Event Webhooks доставляют события жизненного цикла приложения на ваш HTTPS endpoint без постоянного Gateway-соединения.

Настройка

Подготовьте HTTPS endpoint

Endpoint должен быть доступен из интернета, использовать HTTPS и не перенаправлять запрос на другой URL.

Обработайте проверочный PING

При сохранении URL Miscord отправляет payload с type: 0. Ответьте пустым HTTP 204.

Укажите URL

В портале разработчика откройте Расширенные настройки и заполните Event Webhooks URL.

Выберите события

Включите Event Webhooks и отметьте необходимые типы. Сохранение доступно только после успешной проверки endpoint.

Проверочный запрос

{
  "version": 1,
  "application_id": "1234567890",
  "type": 0
}

Ответ не должен содержать тело:

HTTP/1.1 204 No Content

Payload события

{
  "version": 1,
  "application_id": "1234567890",
  "type": 1,
  "event": {
    "type": "APPLICATION_AUTHORIZED",
    "timestamp": "2026-08-09T00:00:00+00:00",
    "data": {}
  }
}

Подтвердите успешную обработку пустым HTTP 204.

Доступные события

Установка приложения

APPLICATION_AUTHORIZED — приложение установлено на сервер или для пользователя.

Удаление приложения

APPLICATION_DEAUTHORIZED — установка приложения отозвана.

Права и игровые события

Также доступны события entitlement, quest enrollment, lobby messages и game direct messages. Включайте только те типы, которые обрабатывает ваш сервис.

При неуспешной доставке Miscord повторяет запросы с увеличивающейся задержкой в пределах десяти минут. Обработчик должен быть идемпотентным.

Защитить endpoint

Проверьте подпись Ed25519 и допустимость timestamp до обработки события.

Входящие вебхуки

События приложения

Настройка

Проверочный запрос

Payload события

Доступные события

Защитить endpoint

​Настройка

​Проверочный запрос

​Payload события

​Доступные события

Защитить endpoint

Настройка

Проверочный запрос

Payload события

Доступные события