Постбэк и API голосования

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

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

Когда игрок голосует за ваш сервер на RealmRanking, наша система отправляет HTTP-запрос GET или POST на настроенный вами URL-адрес. Ваш сервер получает этот запрос и может автоматически вознаградить игрока в игре.

1Игрок голосует за ваш сервер на RealmRanking
2RealmRanking отправляет запрос обратной передачи на настроенный вами URL-адрес.
3Ваш сервер проверяет запрос и вознаграждает игрока.

Настройка URL-адреса обратной передачи

Перейдите на панель управления вашего сервера → Настройки API голосования → введите URL-адрес обратной передачи. URL-адрес должен быть общедоступен в Интернете.

Пример формата URL

https://yourserver.com/vote?user={username}&id={server_id}&ip={ip}

Параметры обратной передачи

Следующие переменные отправляются с каждым запросом Postback:

{username}Внутриигровое имя, которое игрок ввел при голосовании.
{server_id}Ваш уникальный идентификатор сервера RealmRanking
{timestamp}Временная метка Unix, когда было подано голосование
{ip}IP-адрес избирателя для проверки

Пример реализации

Простой пример того, как получить и обработать запрос Postback:

PHP

<?php
$username = $_GET['username'];
$server_id = $_GET['server_id'];
// Награждаем игрока в вашей игровой базе данных
// Пример: отдать 100 монет для голосования пользователю $username
?>

Node.js (Экспресс)

app.get('/vote', (req, res) => {
  const {имя пользователя, server_id} = req.query;
  // Награждаем игрока
  res.sendStatus(200);
});

Тестирование вашего постбека

Используйте кнопку «Проверить обратную передачу» на панели управления сервером, чтобы отправить имитацию голосования на ваш URL-адрес и убедиться, что оно работает правильно.

Политика повтора

Если ваш сервер отключен от сети или URL-адрес возвращает ошибку, RealmRanking повторит обратную передачу до 3 раз в течение 24 часов. Неудачные попытки регистрируются в вашей информационной панели.