API & intégrations

Tout ce qu'il faut pour connecter votre serveur au classement : récompenses de vote en temps réel via NuVotifier, API REST publique pour vérifier les votes et récompenser vos top voteurs, et badge dynamique pour votre site ou Discord.

⚡ Récompenses en temps réel (NuVotifier)

Chaque vote est envoyé à votre serveur en moins d'une seconde via le protocole Votifier (v1 RSA ou v2 token). Installez le plugin NuVotifier, puis configurez l'hôte, le port et le token depuis votre espace : le test de connexion intégré valide la liaison en un clic. Couplé à VotingPlugin ou SuperbVote, le vote déclenche vos récompenses habituelles — le nom de service envoyé est TopModdedServers.

Configurer dans mon espace →

🔌 API REST publique

Endpoints publics, sans authentification, réponses JSON. Merci de rester sous une requête par seconde — les réponses sont mises en cache côté serveur.

Statistiques d'un serveur : votes du mois, total, rang, joueurs en ligne.

GET https://topmoddedservers.com/api/v1/servers/votre-serveur
{
  "slug": "votre-serveur",
  "name": "Votre Serveur",
  "version": "1.20.1",
  "loader": "neoforge",
  "online": true,
  "playersOnline": 42,
  "playersMax": 100,
  "votesMonth": 830,
  "votesTotal": 12408,
  "rank": 3,
  "monthStart": 1785535200,
  "votePageUrl": "https://topmoddedservers.com/serveur/votre-serveur/vote"
}

Vérification par pseudo : votes du mois et des dernières 24 h d'un joueur pour votre serveur — idéal pour rattraper un vote manqué (serveur hors ligne au moment du vote) ou valider une récompense côté plugin.

GET https://topmoddedservers.com/api/v1/servers/votre-serveur/voters/Steve_2024
{
  "username": "Steve_2024",
  "votesMonth": 22,
  "votes24h": 1,
  "lastVoteAt": 1786929671,
  "votedLast24h": true,
  "monthStart": 1785535200
}

Top voteurs du mois de votre serveur : parfait pour une récompense de fin de mois (les compteurs sont remis à zéro le 1ᵉʳ).

GET https://topmoddedservers.com/api/v1/servers/votre-serveur/top-voters
{
  "monthStart": 1785535200,
  "voters": [
    { "username": "Steve_2024", "votes": 27, "lastVoteAt": 1786929671 },
    { "username": "Alex_Craft", "votes": 25, "lastVoteAt": 1786901234 }
  ]
}

lastVoteAt et monthStart sont des timestamps UNIX en secondes.

🏷️ Badge dynamique pour votre site ou Discord

Une image SVG toujours à jour avec votre rang et vos votes du mois, qui renvoie vers votre page de vote. Collez-la sur votre site, votre forum ou votre serveur Discord : chaque badge est aussi un lien qui fait monter votre serveur.

<a href="https://topmoddedservers.com/serveur/votre-serveur/vote">
  <img src="https://topmoddedservers.com/badge/votre-serveur.svg" alt="Votez pour Votre Serveur" />
</a>