Incentive Postback

Автоматически награждайте игроков, которые голосуют за ваш сервер, с помощью простой системы обратного вызова.

Как это работает

Когда игрок голосует за ваш сервер на MMO Top Forge, мы немедленно отправляем GET-запрос на ваш Postback URL с параметрами, содержащими данные о голосовании. Ваш сервер получает уведомление и может автоматически выдать награду игроку — без опроса и API-вызовов.

Настройка

Отредактируйте вашу серверную запись и укажите Postback URL (например, http://yoursite.com/callback.php).
Для вашего сервера генерируется уникальный секрет — используйте его для проверки, что запросы приходят от MMO Top Forge.
Когда игрок голосует, мы вызываем ваш URL с данными голосования.
Ваш скрипт проверяет секрет и выдаёт награду.

Параметры запроса

Ваш Postback URL получает эти параметры при каждом обратном вызове после голосования.

secret  — Ваш API-секрет — для проверки, что запрос пришёл от MMO Top Forge
voted   — 1 = успешный голос, 0 = неудачный или дублированный
userip  — IP-адрес голосующего
userid  — Логин игрока, введённый в форме голосования

Пример запроса

Так выглядит GET-запрос к вашему серверу, когда игрок голосует.

GET http://yoursite.com/callback.php?secret=YOUR_SECRET&voted=1&userip=89.149.92.54&userid=player123

Виджет голосования с Incentive

Укажите URL обратного вызова при добавлении или редактировании вашего сервера. Добавьте параметр ?incentive=PLAYER_ID в ссылку виджета голосования, чтобы автоматически подставить имя игрока в форме голосования. Ваш скрипт получит запрос и сможет выдать награду автоматически — без необходимости опроса.

Incentive Postback — Настройка виджета

Перейдите в раздел добавления сервера или редактируйте существующий.
Заполните поле URL обратного вызова вашим endpoint:
http://yoursite.com/callback.php
На вашем сервере создайте скрипт, который считывает параметры (secret, voted, userip, userid) и выдаёт награду.
Проверяйте параметр secret для подтверждения легитимности запроса.
Запрос отправляется один раз за голос, сразу после прохождения капчи.