Incentive Postback

Belohnen Sie automatisch Spieler, die für Ihren Server abstimmen, mit einem einfachen Callback-System.

So funktioniert es

Wenn ein Spieler auf MMO Top Forge für Ihren Server abstimmt, senden wir sofort eine GET-Anfrage an Ihre Postback-URL mit Abfrageparametern, die die Abstimmungsdetails enthalten. Ihr Server empfängt die Benachrichtigung und kann den Spieler automatisch belohnen — kein Polling oder API-Aufrufe nötig.

Einrichtung

Bearbeiten Sie Ihren Servereintrag und geben Sie Ihre Postback-URL ein (z.B. http://yoursite.com/callback.php).
Ein einzigartiges Secret wird für Ihren Server generiert — verwenden Sie es, um zu bestätigen, dass Anfragen von MMO Top Forge stammen.
Wenn ein Spieler abstimmt, rufen wir Ihre URL mit den Abstimmungsdetails auf.
Ihr Skript überprüft das Secret und vergibt die Belohnung.

Abfrageparameter

Ihre Postback-URL empfängt diese Abfrageparameter bei jedem Abstimmungs-Callback.

secret  — Ihr API-Geheimnis — validiert, dass die Anfrage von MMO Top Forge stammt
voted   — 1 = erfolgreiche Abstimmung, 0 = fehlgeschlagen oder doppelt
userip  — Die IP-Adresse des Abstimmenden
userid  — Der Login-Name des Spielers aus dem Abstimmungsformular

Beispielanfrage

So sieht die GET-Anfrage an Ihren Server aus, wenn ein Spieler abstimmt.

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

Abstimmungs-Widget mit Incentive

Legen Sie eine Postback-URL fest, wenn Sie Ihren Server hinzufügen oder bearbeiten. Fügen Sie den Parameter ?incentive=PLAYER_ID zum Widget-Link hinzu, um den Spielernamen im Abstimmungsformular automatisch auszufüllen. Ihr Skript empfängt die Anfrage und kann die Belohnung automatisch vergeben — kein Polling erforderlich.

Incentive Postback — Widget-Einrichtung

Gehen Sie zu Server hinzufügen oder bearbeiten Sie Ihren bestehenden Eintrag.
Füllen Sie das Postback-URL-Feld mit Ihrem Callback-Endpunkt aus:
http://yoursite.com/callback.php
Erstellen Sie auf Ihrem Server ein Skript, das die Parameter (secret, voted, userip, userid) liest und die Belohnung vergibt.
Validieren Sie den secret-Parameter, um die Legitimität der Anfrage sicherzustellen.
Die Anfrage wird einmal pro Abstimmung gesendet, unmittelbar nachdem der Spieler das Captcha abgeschlossen hat.