Incentive Postback

Recompense automaticamente os jogadores que votam no seu servidor com um sistema simples de callback.

Como funciona

Quando um jogador vota no seu servidor no MMO Top Forge, enviamos imediatamente uma requisição GET para o seu Postback URL com parâmetros contendo os detalhes do voto. Seu servidor recebe a notificação e pode recompensar automaticamente o jogador — sem polling ou chamadas de API.

Configuração

Edite sua listagem de servidor e insira seu Postback URL (ex. http://yoursite.com/callback.php).
Um segredo único é gerado para seu servidor — use-o para validar que as requisições vêm do MMO Top Forge.
Quando um jogador vota, chamamos seu URL com os detalhes do voto.
Seu script verifica o segredo e concede a recompensa.

Parâmetros de consulta

Seu Postback URL recebe estes parâmetros de consulta em cada callback de votação.

secret  — Seu segredo API — valida que a requisição veio do MMO Top Forge
voted   — 1 = voto bem-sucedido, 0 = falho ou duplicado
userip  — O IP do votante
userid  — O nome de login do votante inserido no formulário

Exemplo de requisição

É assim que a requisição GET para seu servidor se parece quando um jogador vota.

GET http://yoursite.com/callback.php?secret=YOUR_SECRET&voted=1&userip=89.149.92.54&userid=player123

Widget de voto com Incentive

Defina uma URL de Postback ao adicionar ou editar seu servidor. Adicione o parâmetro ?incentive=PLAYER_ID ao link do widget de voto para preencher automaticamente o nome do jogador no formulário de votação. Seu script recebe a requisição e pode conceder a recompensa automaticamente — sem necessidade de polling.

Incentive Postback — Configuração do widget

Vá para Adicionar Servidor ou edite seu anúncio existente.
Preencha o campo URL de Postback com seu endpoint:
http://yoursite.com/callback.php
No seu servidor, crie um script que leia os parâmetros (secret, voted, userip, userid) e conceda a recompensa.
Valide o parâmetro secret para garantir que a requisição é legítima.
A requisição é enviada uma vez por voto, imediatamente após o jogador completar o captcha.