Перейти к содержимому
/ru/developers/vote-reward

Для разработчиков: награда за голос

Как получать голоса игроков на свой сервер и выдавать награду автоматически. Настройка — в кабинете владельца, раздел «Награда за голос».

Webhook

На каждый голос с ником за ваш сервер отправляем POST с JSON (поля ниже). Подпись — в заголовке X-Mmohub-Signature: sha256= и HMAC-SHA256 тела запроса по вашему секретному ключу. Ответьте 2xx — голос отметится «доставлен». При ошибке повторим через 1, 10 и 30 минут. Адрес — только https, перенаправления не выполняем.

Тело запроса (POST, JSON)
{
  "id": 81234,
  "project": "veloria",
  "server": "veloria-x50",
  "nickname": "DarkElfRogue",
  "votedAt": "2026-09-25T14:31:18+03:00"
}

API

Если webhook неудобен, выберите способ «API»: забирайте новые голоса запросом GET и отмечайте выданные запросом POST. Ключ передаётся в заголовке Authorization: Bearer.

Забор голосов (способ «API»)
GET  https://mmohub.gg/api/v1/rewards/votes?server=<slug>&after=<id>
POST https://mmohub.gg/api/v1/rewards/votes/<id>/delivered?server=<slug>
Authorization: Bearer <key>

Вручную

Способ «Вручную» — выгрузка голосов за день в CSV из кабинета.

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

Проверяйте подпись каждого запроса и не выдавайте награду дважды за один id. Голос с полем test: true — тестовый из кабинета, награду за него не выдавайте. Ключ можно заменить в кабинете в любой момент.

Настроить награду →
Остался вопрос? Напишите нам