RealmRanking

Postback et API de vote

Récompensez automatiquement vos joueurs lorsqu'ils votent pour votre serveur.

Comment ça fonctionne

Lorsqu'un joueur vote pour votre serveur sur RealmRanking, notre système envoie une requête HTTP GET ou POST à une URL que vous configurez. Votre serveur reçoit cette requête et peut récompenser le joueur en jeu automatiquement.

  1. 1Le joueur vote pour votre serveur sur RealmRanking
  2. 2RealmRanking envoie une requête Postback à votre URL configurée
  3. 3Votre serveur valide la requête et récompense le joueur

Configurer votre URL Postback

Allez dans le dashboard de votre serveur → Paramètres Voting API → saisissez votre URL Postback. L'URL doit être accessible publiquement depuis Internet.

Format d'URL exemple

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

Paramètres Postback

Les variables suivantes sont envoyées avec chaque requête Postback :

  • {username}Le nom en jeu saisi par le joueur lors du vote
  • {server_id}Votre identifiant serveur RealmRanking unique
  • {timestamp}Horodatage Unix du moment du vote
  • {ip}L'adresse IP du votant pour validation

Exemple d'implémentation

Un exemple simple de réception et traitement d'une requête 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);
});

Tester votre Postback

Utilisez le bouton Test Postback dans le dashboard de votre serveur pour envoyer un vote simulé à votre URL et vérifier qu'il fonctionne correctement.

Politique de nouvelle tentative

Si votre serveur est hors ligne ou si l'URL renvoie une erreur, RealmRanking réessaiera le Postback jusqu'à 3 fois sur 24 heures. Les tentatives échouées sont enregistrées dans votre dashboard.