VOTING API

Überprüfe die Stimmen deiner Spieler in Echtzeit und automatisiere deine In-Game-Belohnungen.

01. Einführung

Die McServ API ermöglicht es Server-Administratoren zu prüfen, ob ein Nutzer am aktuellen Kalendertag abgestimmt hat. Die Stimmen werden täglich um 00:00 (UTC) zurückgesetzt.

02. Warum die API nutzen?

VERLUSTFREIE ZUVERLÄSSIGKEIT

Im Gegensatz zu Votifier-Benachrichtigungen, die verloren gehen können, wenn dein Server offline ist, ermöglicht die API eine Überprüfung bei der Anmeldung des Spielers.

SHOPS & WEBSTORES

Prüfe Stimmen in deinem Webshop, um Rabatte zu gewähren, ohne dass der Spieler im Spiel sein muss.

STATS & DASHBOARDS

Zeige eine dynamische Erinnerung auf deiner Seite oder im Launcher an, ob ein Spieler heute schon abgestimmt hat.

03. Deinen Slug abrufen

Der Slug ist die permanente Text-ID in der URL deines Servers. Er ist stabiler als die numerische ID.

mcserv.org/servers/slug_de_votre_serveur

→ ID, die aus deiner öffentlichen McServ-URL extrahiert wird.

04. Endpunkte

GET slug/IP

Antwort text/plain : 1 (abgestimmt) oder 0 (nicht abgestimmt).

GET slug/IP/json

Detaillierte JSON-Antwort inklusive Zeitstempel und Mitternachts-Reset.

ANTWORT_VORSCHAU:

{
  "vote": "1",
  "voted_at": "2026-02-05T14:20:01Z",
  "reset": true,
  "next_in": 34799
}