RealmRanking

Postback & Voting-API

Belohne deine Spieler automatisch, wenn sie für deinen Server voten.

So funktioniert es

Wenn ein Spieler für deinen Server auf RealmRanking votet, sendet unser System eine HTTP-GET- oder POST-Anfrage an eine von dir konfigurierte URL. Dein Server empfängt diese Anfrage und kann den Spieler automatisch im Spiel belohnen.

  1. 1Spieler votet für deinen Server auf RealmRanking
  2. 2RealmRanking sendet eine Postback-Anfrage an deine konfigurierte URL
  3. 3Dein Server validiert die Anfrage und belohnt den Spieler

Postback-URL einrichten

Gehe zu deinem Server-Dashboard → Voting-API-Einstellungen → gib deine Postback-URL ein. Die URL muss öffentlich aus dem Internet erreichbar sein.

Beispiel-URL-Format

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

Postback-Parameter

Die folgenden Variablen werden mit jeder Postback-Anfrage gesendet:

  • {username}Der In-Game-Name, den der Spieler beim Voten eingegeben hat
  • {server_id}Deine eindeutige RealmRanking-Server-ID
  • {timestamp}Unix-Zeitstempel des Votings
  • {ip}Die IP-Adresse des Wählers zur Validierung

Beispielimplementierung

Ein einfaches Beispiel zum Empfangen und Verarbeiten einer Postback-Anfrage:

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 testen

Nutze die Schaltfläche Test Postback in deinem Server-Dashboard, um eine simulierte Stimme an deine URL zu senden und die Funktion zu prüfen.

Wiederholungsrichtlinie

Wenn dein Server offline ist oder die URL einen Fehler zurückgibt, wiederholt RealmRanking den Postback bis zu 3 Mal innerhalb von 24 Stunden. Fehlgeschlagene Versuche werden in deinem Dashboard protokolliert.