RealmRanking

Postback és Szavazási API

Jutalmazd automatikusan játékosaidat, amikor a szerveredre szavaznak.

Hogyan működik

Amikor egy játékos a RealmRankingen szavaz a szerveredre, rendszerünk HTTP GET vagy POST kérést küld a beállított URL-re. A szervered megkapja a kérést és automatikusan jutalmazhatja a játékost.

  1. 1A játékos a RealmRankingen szavaz a szerveredre
  2. 2A RealmRanking Postback kérést küld a beállított URL-re
  3. 3A szervered ellenőrzi a kérést és jutalmazza a játékost

Postback URL beállítása

Lépj a szerver vezérlőpultjára → Voting API beállítások → add meg a Postback URL-t. Az URL-nek nyilvánosan elérhetőnek kell lennie az internetről.

Példa URL formátum

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

Postback paraméterek

A következő változók kerülnek elküldésre minden Postback kérésnél:

  • {username}A játékos által megadott játékbeli név szavazáskor
  • {server_id}Egyedi RealmRanking szerverazonosítód
  • {timestamp}Unix időbélyeg a szavazat leadásának idejéről
  • {ip}A szavazó IP-címe ellenőrzéshez

Példa implementáció

Egyszerű példa Postback kérés fogadására és feldolgozására:

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);
});

Postback tesztelése

Használd a Test Postback gombot a szerver vezérlőpultján szimulált szavazat küldéséhez és ellenőrzéshez.

Újrapróbálkozási szabály

Ha a szerver offline vagy az URL hibát ad vissza, a RealmRanking legfeljebb 3 alkalommal próbálkozik újra 24 órán belül. A sikertelen kísérletek naplózva vannak.