RealmRanking

Postback y API de votación

Recompensa automáticamente a tus jugadores cuando voten por tu servidor.

Cómo funciona

Cuando un jugador vota por tu servidor en RealmRanking, nuestro sistema envía una solicitud HTTP GET o POST a una URL que configures. Tu servidor recibe esta solicitud y puede recompensar al jugador en el juego automáticamente.

  1. 1El jugador vota por tu servidor en RealmRanking
  2. 2RealmRanking envía una solicitud Postback a tu URL configurada
  3. 3Tu servidor valida la solicitud y recompensa al jugador

Configurar tu URL Postback

Ve al dashboard de tu servidor → Ajustes Voting API → introduce tu URL Postback. La URL debe ser accesible públicamente desde Internet.

Formato de URL de ejemplo

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

Parámetros Postback

Las siguientes variables se envían con cada solicitud Postback:

  • {username}El nombre en el juego que el jugador introdujo al votar
  • {server_id}Tu ID de servidor RealmRanking único
  • {timestamp}Marca de tiempo Unix de cuándo se emitió el voto
  • {ip}La dirección IP del votante para validación

Ejemplo de implementación

Un ejemplo simple de cómo recibir y procesar una solicitud 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);
});

Probar tu Postback

Usa el botón Test Postback en el dashboard de tu servidor para enviar un voto simulado a tu URL y verificar que funciona correctamente.

Política de reintentos

Si tu servidor está offline o la URL devuelve un error, RealmRanking reintentará el Postback hasta 3 veces en 24 horas. Los intentos fallidos se registran en tu dashboard.