LogoServeurly.com
API REST v1

Documentation API Développeurs

Intégrez vos serveurs de jeux (Rust, Minecraft, FiveM, ARK, Garry's Mod, 7 Days to Die, etc.) ou votre boutique en ligne à Serveurly pour vérifier les votes de vos joueurs et distribuer automatiquement leurs récompenses.

Authentification

Chaque serveur possède une clé API unique accessible dans l'espace de gestion.

Anti-double réclamation

Les réclamations sont verrouillées en base de données pour empêcher tout doublon.

Limite de requêtes

60 requêtes par minute par serveur pour assurer une réponse rapide et stable.

1. Authentification & Base URL

URL de base

https://serveurly.com/api/v1

Les requêtes doivent inclure le token de votre serveur (srv_live_...), disponible sur la page Gestion des serveurs .

Formats d'authentification acceptés :

Header HTTP : Authorization: Bearer srv_live_xxxx

Header alternatif : X-Server-Token: srv_live_xxxx

Paramètre URL : ?token=srv_live_xxxx

2. Endpoints

GET
/api/v1/votes/check

Vérifie si un joueur a voté dans les 2 dernières heures sans consommer le vote.

Paramètres (Query)

username ou pseudo (string) : Pseudo du joueur

ip (string, optionnel) : Adresse IP du joueur

Exemple de réponse (200 OK)

{
  "success": true,
  "data": {
    "has_voted": true,
    "is_claimed": false,
    "voted_at": "2026-08-20T16:45:00.000Z",
    "voted_at_timestamp": 1787244300,
    "next_vote_at": "2026-08-20T18:45:00.000Z",
    "next_vote_seconds": 0,
    "voter": {
      "username": "Alexis",
      "ip": "82.64.12.34"
    }
  }
}
POST
/api/v1/votes/claim

Vérifie le vote récent du joueur et le marque immédiatement comme réclamé. Empêche de donner deux fois une récompense pour le même vote.

Paramètres (JSON Body ou Query)

{
  "username": "Alexis"
}

Réponse : Vote réclamé avec succès (200 OK)

{
  "success": true,
  "data": {
    "status": "claimed",
    "message": "Vote réclamé avec succès.",
    "vote_id": 9821,
    "username": "Alexis",
    "voted_at": "2026-08-20T16:45:00.000Z",
    "voted_at_timestamp": 1787244300,
    "claimed_at": "2026-08-20T16:50:12.000Z"
  }
}

Réponse : Vote déjà réclamé (200 OK)

{
  "success": false,
  "error": {
    "code": "ALREADY_CLAIMED",
    "message": "Ce vote a déjà été réclamé.",
    "voted_at": "2026-08-20T16:45:00.000Z",
    "claimed_at": "2026-08-20T16:50:12.000Z"
  }
}
GET
/api/v1/server
GET
/api/v1/votes/top
GET
/api/v1/votes/recent

3. Codes d'erreurs & Réponses HTTP

200 OK

Requête réussie

L'opération a été effectuée. Le champ success indique le résultat métier.

400 Bad Request

Paramètres manquants

Code MISSING_IDENTIFIER : pseudo ou adresse IP manquant.

401 Unauthorized

Authentification invalide

Code UNAUTHORIZED ou INVALID_TOKEN : clé API absente, invalide ou expirée.

429 Rate Limit

Quota de requêtes dépassé

Limite de 60 requêtes par minute dépassée.

Intégrer l'API Serveurly sur votre serveur

Récupérez votre clé API dans votre espace de gestion pour commencer à récompenser vos joueurs.

Accéder à mes serveurs