Postback e API de votação

Recompense automaticamente seus jogadores quando eles votarem em seu servidor.

Como funciona

Quando um jogador vota em seu servidor em RealmRanking, nosso sistema envia uma solicitação HTTP GET ou POST para uma URL que você configura. Seu servidor recebe esta solicitação e pode recompensar o jogador automaticamente no jogo.

1Os jogadores votam no seu servidor em RealmRanking
2RealmRanking envia uma solicitação de postback para sua URL configurada
3Seu servidor valida a solicitação e recompensa o jogador

Configurando seu URL de postback

Vá para o painel do servidor → Configurações da API de votação → insira seu URL de postback. O URL deve ser acessível publicamente na Internet.

Exemplo de formato de URL

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

Parâmetros de postback

As seguintes variáveis são enviadas com cada solicitação de postback:

{username}O nome do jogo que o jogador digitou ao votar
{server_id}Seu ID exclusivo do servidor RealmRanking
{timestamp}Carimbo de data e hora Unix de quando o voto foi lançado
{ip}O endereço IP do eleitor para validação

Exemplo de implementação

Um exemplo simples de como receber e processar uma solicitação de Postback:

PHP

<?php
$nomedeusuário = $_GET['nomedeusuário'];
$server_id = $_GET['server_id'];
// Recompense o jogador em seu banco de dados do jogo
// Exemplo: dê 100 moedas de voto para $username
?>

Node.js (Expresso)

app.get('/voto', (req, res) => {
  const {nome de usuário, server_id} = req.query;
  //Recompensa o jogador
  res.sendStatus(200);
});

Testando seu postback

Use o botão Test Postback no painel do servidor para enviar uma votação simulada para sua URL e verificar se ela funciona corretamente.

Política de Nova Tentativa

Se o seu servidor estiver offline ou a URL retornar um erro, RealmRanking tentará novamente o postback até 3 vezes em 24 horas. As tentativas fracassadas são registradas em seu painel.