RealmRanking

Postback și API de votare

Recompensează automat jucătorii când votează pentru serverul tău.

Cum funcționează

Când un jucător votează pentru serverul tău pe RealmRanking, sistemul nostru trimite o cerere HTTP GET sau POST către un URL configurat de tine. Serverul tău primește cererea și poate recompensa jucătorul în joc automat.

  1. 1Jucătorul votează pentru serverul tău pe RealmRanking
  2. 2RealmRanking trimite o cerere Postback către URL-ul configurat
  3. 3Serverul tău validează cererea și recompensează jucătorul

Configurarea URL-ului Postback

Mergi la panoul serverului → Setări Voting API → introdu URL-ul Postback. URL-ul trebuie să fie accesibil public de pe internet.

Format URL exemplu

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

Parametri Postback

Următoarele variabile sunt trimise cu fiecare cerere Postback:

  • {username}Numele din joc introdus de jucător la votare
  • {server_id}ID-ul unic al serverului tău pe RealmRanking
  • {timestamp}Marcaj temporal Unix al momentului votului
  • {ip}Adresa IP a votantului pentru validare

Exemplu de implementare

Un exemplu simplu de primire și procesare a unei cereri 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);
});

Testarea Postback-ului

Folosește butonul Test Postback din panoul serverului pentru a trimite un vot simulat către URL și a verifica funcționarea.

Politica de reîncercare

Dacă serverul este offline sau URL-ul returnează o eroare, RealmRanking va reîncerca Postback-ul de până la 3 ori în 24 de ore. Încercările eșuate sunt înregistrate în panou.