RealmRanking

Postback i API głosowania

Automatycznie nagradzaj graczy, gdy głosują na Twój serwer.

Jak to działa

Gdy gracz głosuje na Twój serwer w RealmRanking, nasz system wysyła żądanie HTTP GET lub POST na skonfigurowany URL. Twój serwer odbiera żądanie i może automatycznie nagrodzić gracza w grze.

  1. 1Gracz głosuje na Twój serwer w RealmRanking
  2. 2RealmRanking wysyła żądanie Postback na skonfigurowany URL
  3. 3Twój serwer weryfikuje żądanie i nagradza gracza

Konfiguracja URL Postback

Przejdź do panelu serwera → Ustawienia Voting API → wprowadź URL Postback. URL musi być publicznie dostępny z internetu.

Przykładowy format URL

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

Parametry Postback

Następujące zmienne są wysyłane z każdym żądaniem Postback:

  • {username}Nazwa w grze podana przez gracza podczas głosowania
  • {server_id}Unikalny identyfikator serwera RealmRanking
  • {timestamp}Znacznik czasu Unix momentu oddania głosu
  • {ip}Adres IP głosującego do weryfikacji

Przykładowa implementacja

Prosty przykład odbierania i przetwarzania żądania Postback:

PHP
<?php
$username = $_GET['username'];
$server_id = $_GET['server_id'];
// Reward the player in your game database
// Example: give 100 vote coins to $username
?>
Node.js (Express)
app.get('/vote', (req, res) => {
  const { username, server_id } = req.query;
  // Reward the player
  res.sendStatus(200);
});

Testowanie Postback

Użyj przycisku Test Postback w panelu serwera, aby wysłać symulowany głos na URL i sprawdzić poprawność działania.

Polityka ponawiania

Jeśli serwer jest offline lub URL zwraca błąd, RealmRanking ponowi Postback do 3 razy w ciągu 24 godzin. Nieudane próby są logowane w panelu.