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.