Web Requests
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.
Ö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.“
Neues Profil öffnet ein leeres Formular.
Profil anlegen
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ßerdemhttp://localhostundhttp://127.0.0.1. Anderehttp://-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):
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:
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.
Hinweis
Die Gildengefechte merken sich das Profil über seinen Namen. Benennst du ein Profil um oder löschst es, verschwinden die Knöpfe, bis du das Profil im Tab Senden neu wählst.
Einstellungen
Das Fenster hat kein eigenes Zahnrad. Welches Profil die Gildengefechte nutzen, stellst du in den Einstellungen der Gildengefechte ein (siehe
Häufige Fragen
Mein Server bekommt nichts.
Der Helfer zeigt die Erfolgsmeldung immer, auch wenn der Request scheitert. Prüfe die URL in der
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
- Discord Webhooks – Meldungen direkt in einen Discord-Channel, auch automatisch
- Gildengefechte
- Fenster-Knöpfe
- Menüleiste