Incentive Postback

Récompensez automatiquement les joueurs qui votent pour votre serveur avec un simple système de callback.

Comment ça marche

Lorsqu'un joueur vote pour votre serveur sur MMO Top Forge, nous envoyons immédiatement une requête GET à votre Postback URL avec des paramètres contenant les détails du vote. Votre serveur reçoit la notification et peut récompenser automatiquement le joueur — sans polling ni appels API.

Configuration

Modifiez votre annonce serveur et entrez votre Postback URL (ex. http://yoursite.com/callback.php).
Un secret unique est généré pour votre serveur — utilisez-le pour valider que les requêtes proviennent de MMO Top Forge.
Quand un joueur vote, nous appelons votre URL avec les détails du vote.
Votre script vérifie le secret et accorde la récompense.

Paramètres de requête

Votre Postback URL reçoit ces paramètres de requête à chaque callback de vote.

secret  — Votre secret API — valide que la requête provient de MMO Top Forge
voted   — 1 = vote réussi, 0 = échoué ou dupliqué
userip  — L'IP du votant
userid  — Le nom de connexion du votant saisi dans le formulaire

Exemple de requête

Voici à quoi ressemble la requête GET vers votre serveur lorsqu'un joueur vote.

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

Widget de vote avec Incentive

Définissez une URL de Postback lors de l'ajout ou la modification de votre serveur. Ajoutez le paramètre ?incentive=PLAYER_ID au lien du widget de vote pour pré-remplir automatiquement le nom du joueur dans le formulaire de vote. Votre script reçoit la requête et peut accorder la récompense automatiquement — aucun polling requis.

Incentive Postback — Configuration du widget

Allez dans Ajouter un Serveur ou modifiez votre annonce existante.
Remplissez le champ URL de Postback avec votre endpoint :
http://yoursite.com/callback.php
Sur votre serveur, créez un script qui lit les paramètres (secret, voted, userip, userid) et accorde la récompense.
Validez le paramètre secret pour vous assurer que la requête est légitime.
La requête est envoyée une fois par vote, immédiatement après que le joueur a complété le captcha.