Webhooks - Real-Time Server Events
Find the perfect server in milliseconds
Beschikbare Server-Events
Kies welke gebeurtenissen je wilt ontvangen via jouw webhook-endpoint. ServerScout stuurt direct een POST-verzoek zodra er wijzigingen optreden op gemonitorde Minecraft, FiveM of Rust servers.
server_status_changed
Wordt getriggerd wanneer een server offline gaat of weer online komt. Bijvoorbeeld: `MC-DutchCraft` verliest connectiviteit na de wekelijkse maandag-update en keert 12 minuten later terug met build 1.20.4.
Belangrijk voor: Discord-kanalen, statuspagina's, automatische herstartscripts.
mod_load_updated
Wordt verzonden wanneer de mod-lijst of plugin-configuratie verandert. Denk aan `Rust-AlphaNL` dat `Oxide Modpack v3.8.2` implementeert, of `FiveM-Groningen` dat `ESX Framework` updatet naar versie 1.14.
Belangrijk voor: compatibiliteitschecks, automatische client-updates.
player_capacity_reached
Activeert zodra het speleraantal de maximale capaciteit bereikt. Bijvoorbeeld: `Valheim-Holland` springt van 68 naar 75/75 spelers tijdens het weekend-event.
Belangrijk voor: wachtlijst-managers, load-balancing notificaties.
Webhook Payload Structuur
Elk webhook-verzoek bevat een gestandaardiseerd JSON-object met tijdslabels, server-identificatie en specifieke event-data. Alle payloads worden gesigneerd met HMAC-SHA256 voor verificatie.
Het onderstaande voorbeeld toont een `player_capacity_reached` notificatie voor de server `Minecraft-Vlaanderen`:
{ "event": "player_capacity_reached", "timestamp": "2024-05-14T19:42:08Z", "server_id": "mc-vl-8842", "server_name": "Minecraft-Vlaanderen", "game": "minecraft_java", "data": { "current_players": 99, "max_players": 100, "region": "eu-west", "last_tick": 1742985728 } }
Verificatie gebeurt via de `X-ServerScout-Signature` header. Controleer de payload-integriteit voordat je acties uitvoert. Onverwerkte of ongeldige requests worden na 3 pogingen automatisch gedemp om server-overbelasting te voorkomen.
Download voorbeeld payloadsStap-voor-Stap Instellen
Koppel jouw webhook-endpoint binnen 5 minuten. ServerScout ondersteunt HTTPS-endpoints, Discord webhooks en custom API-routes zonder extra middleware.
Stap 1: Endpoint registreren
Log in op je ServerScout dashboard en navigeer naar `Instellingen > Integraties > Webhooks`. Voer een geldig HTTPS-adres in, bijvoorbeeld `https://hooks.jouwserver.nl/scout/events`. Test de connectiviteit met de `Stuur testverzoek` knop.
Stap 2: Event filters configureren
Selecteer de servergroepen die je wilt monitoren. Je kunt filters instellen op basis van game (`minecraft_bedrock`, `fivem`, `rust`), regio (`eu-central`, `sa-east`) of minimale speldichtheid. Stel een retry-beleid in: standaard 3 pogingen met exponentiële backoff (2s, 5s, 12s).
Stap 3: Verificatie & logging
Activeer payload-signatuur verificatie door je secret key te kopiëren naar je applicatie-omgeving. ServerScout logt alle verzonden requests met statuscodes. Bij `429 Too Many Requests` schakelt het systeem automatisch over naar queue-mode om data niet te verliezen.
Klaar voor productie? Activeer je webhook en ontvang binnen 30 seconden je eerste live notificatie.
Maak webhook aan