Incentive Postback

Premia automaticamente i giocatori che votano per il tuo server con un semplice sistema di callback.

Come funziona

Quando un giocatore vota per il tuo server su MMO Top Forge, inviamo immediatamente una richiesta GET al tuo Postback URL con parametri contenenti i dettagli del voto. Il tuo server riceve la notifica e può premiare automaticamente il giocatore — senza polling o chiamate API.

Configurazione

Modifica il tuo annuncio server e inserisci il tuo Postback URL (es. http://yoursite.com/callback.php).
Viene generato un segreto univoco per il tuo server — usalo per verificare che le richieste provengano da MMO Top Forge.
Quando un giocatore vota, chiamiamo il tuo URL con i dettagli del voto.
Il tuo script verifica il segreto e assegna la ricompensa.

Parametri di query

Il tuo Postback URL riceve questi parametri di query ad ogni callback di votazione.

secret  — Il tuo segreto API — valida che la richiesta proviene da MMO Top Forge
voted   — 1 = voto riuscito, 0 = fallito o duplicato
userip  — L'IP del votante
userid  — Il nome di login del votante inserito nel modulo

Esempio di richiesta

Ecco come appare la richiesta GET al tuo server quando un giocatore vota.

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

Widget di voto con Incentive

Imposta un URL di Postback quando aggiungi o modifichi il tuo server. Aggiungi il parametro ?incentive=PLAYER_ID al link del widget di voto per compilare automaticamente il nome del giocatore nel modulo di votazione. Il tuo script riceve la richiesta e può assegnare la ricompensa automaticamente — senza bisogno di polling.

Incentive Postback — Configurazione widget

Vai ad Aggiungi Server o modifica il tuo annuncio esistente.
Compila il campo URL Postback con il tuo endpoint:
http://yoursite.com/callback.php
Sul tuo server, crea uno script che legge i parametri (secret, voted, userip, userid) e assegna la ricompensa.
Valida il parametro secret per assicurarti che la richiesta sia legittima.
La richiesta viene inviata una volta per voto, subito dopo che il giocatore completa il captcha.