Ajouter un serveur

API VoteServeur v1

Récompenses de votes pour les 51 jeux du catalogue (FiveM, DayZ, ARK, Rust, Minecraft…). Même modèle partout : server_token secret + pseudo in-game (ou SteamID).

Base URL

https://voteserveur.fr/api/v1

Token serveur

Le server_token est visible uniquement par le propriétaire (page gestion, ou onglet voter une fois connecté). À garder secret côté serveur de jeu. Sans token valide, l’API ne révèle rien d’exploitable (404).

Tu peux aussi l’envoyer en en-tête X-Server-Token ou Authorization: Bearer TOKEN (évite de le coller dans les logs d’URL).

Parcours joueur

  1. Le joueur vote sur le site et saisit son pseudo in-game (et SteamID optionnel).
  2. Ton script appelle claim-username (ou claim-steam) toutes les X secondes / à la connexion.
  3. Si claimed = 1 → donne la récompense une seule fois.

GET /votes/claim-username

Réclame un vote des 2 dernières heures via pseudo. Impossible d’injecter un vote : il doit déjà exister.

GET https://voteserveur.fr/api/v1/votes/claim-username?server_token=TOKEN&playername=Pseudo
{
  "code": 200,
  "success": true,
  "claimed": 1,
  "message": "Vote réclamé"
}

GET /votes/claim-steam

GET https://voteserveur.fr/api/v1/votes/claim-steam?server_token=TOKEN&steam_id=76561198000000000

GET /votes/check

Vérifie sans consommer (0 = pas voté, 1 = déjà réclamé, 2 = voté non réclamé).

GET https://voteserveur.fr/api/v1/votes/check?server_token=TOKEN&playername=Pseudo

GET /votes/last

Derniers votes (1 h) — stats / debug, token requis.

GET https://voteserveur.fr/api/v1/votes/last?server_token=TOKEN

GET /server

GET https://voteserveur.fr/api/v1/server?server_token=TOKEN

Scripts & plugins

Pack ZIP généré pour chaque jeu du catalogue (natif ou poller universel), token injecté, téléchargement réservé au propriétaire :

Exemple curl

curl -s -H 'X-Server-Token: TOKEN' 'https://voteserveur.fr/api/v1/votes/claim-username?playername=Nayvroxi'