Web Requests

Spieldaten per GET/POST an einen eigenen Server schicken.

Web Requests schickt Sektor-Daten aus den Gildengefechten per HTTP-Request an deinen eigenen Server – als GET mit URL-Parametern oder als POST mit JSON- oder Formular-Body. Was der Server damit macht (Bot, Tabelle, Datenbank), bestimmst du selbst. Für Meldungen direkt in einen Discord-Channel gibt es Discord Webhooks.

Das Fenster Web Requests mit der Liste der Profile
Das Fenster Web Requests mit der Liste der Profile

Öffnen

  • Menüleiste: Symbol Web Requests (siehe Menüleiste).
  • Im Fenster Gildengefechte unter Zahnrad → Tab Senden: Solange noch kein Profil existiert, steht dort „Kein Profil verfügbar. Bitte erstellen“ mit dem Knopf Öffnen.

Das Fenster öffnet sich nie von selbst.

Profile

Ein Profil beschreibt einen Request: Ziel, Methode und Inhalt. Die Liste Profile zeigt je Profil den Namen, die Methode und die Ziel-URL. Gibt es noch keins, steht dort „Noch keine Profile angelegt.“

Knopf Wirkung
Test senden Schickt das Profil mit Beispielwerten an den Server.
Bearbeiten Öffnet das Profil im Formular.
Papierkorb Löscht das Profil sofort und ohne Rückfrage.

Neues Profil öffnet ein leeres Formular.

Profil anlegen

Das Formular eines POST-Profils mit Body-Vorlage und Vorschau
Das Formular eines POST-Profils mit Body-Vorlage und Vorschau
Feld Bedeutung
Name Unter diesem Namen wählst du das Profil in den Gildengefechten aus.
Ziel-URL Adresse deines Servers. Sie darf Platzhalter enthalten, z. B. https://example.com/gbg.php?sector=#name&attrition=#attrition. Die Werte werden dabei URL-kodiert.
Methode GET – Werte als URL-Parameter oder POST – Werte im Body.
Body-Format Nur bei POST: JSON (in PHP: php://input) oder Formular (in PHP: $_POST).
Body-Vorlage Nur bei POST: der Inhalt des Requests mit Platzhaltern. Vorbelegt mit allen Platzhaltern im gewählten Format.

Wechselst du das Body-Format, tauscht der Helfer die Vorlage nur aus, solange sie leer ist oder noch unverändert der Vorgabe des anderen Formats entspricht.

Unten stehen die Knöpfe Abbrechen, Vorschau, Test senden und Speichern. Beim Speichern prüft der Helfer:

  • Name und Ziel-URL müssen ausgefüllt sein, sonst: „Bitte Name und Ziel-URL angeben!“
  • Die URL muss mit https:// beginnen. Erlaubt sind außerdem http://localhost und http://127.0.0.1. Andere http://-Ziele blockiert der Browser als Mixed Content.

Body-Formate

Die Platzhalter werden JSON-sicher eingesetzt (Anführungszeichen und Sonderzeichen maskiert), aber ohne eigene Anführungszeichen – die setzt du in der Vorlage. Der Body geht als einfacher Text raus, ohne Content-Type: application/json; in PHP liest du ihn über php://input. Vorgabe:

{
	"sector": "#name",
	"battletype": "#battletype",
	"time": #time,
	"attrition": "#attrition",
	"guild": "#guild",
	"vp": "#vp",
	"neighbors": "#neighbors",
	"player": "#player",
	"world": "#world"
}

Eine Zeile je Feld im Format schlüssel=wert. Leere Zeilen und Zeilen ohne = werden übersprungen. Der Body geht als application/x-www-form-urlencoded raus; in PHP landen die Werte in $_POST. Vorgabe:

sector=#name
battletype=#battletype
time=#time
attrition=#attrition
guild=#guild
vp=#vp
neighbors=#neighbors
player=#player
world=#world

Vorschau

Vorschau zeigt Methode, fertige URL und – bei POST – den fertigen Body mit diesen Beispielwerten (dieselben nutzt Test senden):

Platzhalter Beispielwert
#name A1 - Test Province
#battletype 🔴
#time jetzt + 5 Minuten (Unix-Zeitstempel)
#attrition 42
#guild Test Guild
#vp 96 (+4)
#neighbors Guild A, Guild B
#player dein Spielername
#world deine Welt

Ist der JSON-Body danach kein gültiges JSON, steht unter der Vorschau „Der Body ist kein gültiges JSON.“ Die Vorschau aktualisiert sich beim Öffnen des Formulars und bei Vorschau bzw. Test senden, nicht beim Tippen.

Ohne Antwort (fire-and-forget)

Requests werden abgeschickt, ohne auf eine Antwort zu warten. Der Helfer wertet weder die Antwort noch Fehler aus und meldet immer „Der Request wurde abgeschickt (Antwort wird nicht ausgewertet).“ Eigene Header (etwa für eine Anmeldung) lassen sich nicht setzen.

Platzhalter

Es gelten dieselben Platzhalter wie bei den Discord-Vorlagen:

Platzhalter Wert
#name Name des Sektors
#battletype 🔴 bei Angriffs-Kampftyp, sonst 🔵
#time Öffnungszeitpunkt als Unix-Zeitstempel (Sekunden)
#attrition Zermürbungschance des Sektors als Zahl (ohne %)
#guild Gilde, der der Sektor gehört
#vp Siegpunkte des Sektors, ein Bonus in Klammern, z. B. 96 (+4)
#neighbors angrenzende Gilden, mit Komma getrennt – ohne deine eigene Gilde und ohne den Besitzer
#player dein Spielername
#world deine Welt, z. B. de12

Siegpunkte, Nachbarn und Zermürbungschance können sich bis zum Öffnen des Sektors noch ändern; gesendet wird der Stand beim Klick.

Einsatz in den Gildengefechten

Im Fenster Gildengefechte öffnest du das Zahnrad (siehe Fenster-Knöpfe), wechselst in den Tab Senden und wählst im Abschnitt Web Requests ein Profil (Bitte wählen = aus). Speichern übernimmt die Auswahl.

Danach zeigt die Live-Übersicht in der Liste der anstehenden Sektoren bei jedem Sektor, der nicht deiner Gilde gehört, den Knopf Per Web-Request senden. Klickst du Zeilen an, werden sie markiert, und über der Liste erscheint Auswahl per Web-Request senden: ein Request je markiertem Sektor, sortiert nach Öffnungszeit, mit einer gemeinsamen Erfolgsmeldung.

Anders als bei Discord Webhooks gibt es kein automatisches Senden – Web Requests gehen nur per Klick raus.

Einstellungen

Das Fenster hat kein eigenes Zahnrad. Welches Profil die Gildengefechte nutzen, stellst du in den Einstellungen der Gildengefechte ein (siehe oben).

Häufige Fragen

Mein Server bekommt nichts. Der Helfer zeigt die Erfolgsmeldung immer, auch wenn der Request scheitert. Prüfe die URL in der Vorschau und schau in die Logs deines Servers. CORS-Header braucht dein Server nicht, weil der Helfer die Antwort ohnehin nicht liest.

Beim Speichern kommt „Nur https:// URLs (oder http://localhost) sind möglich“. Das Spiel läuft über https, deshalb lässt der Browser keine Requests an unverschlüsselte Adressen zu. Nutze eine https-Adresse oder für Tests http://localhost.

Mein PHP-Skript findet die JSON-Werte nicht in $_POST. JSON landet nicht in $_POST. Lies den Body über php://input oder stelle das Profil auf Formular (in PHP: $_POST) um.

Siehe auch