Vue d'ensemble
Toutes les routes publiques sont sous /api/v1/module. Les réponses réussies utilisent toujours apiVersion, generatedAt et data.
GET /api/v1 — Index public
GET /api/v1/modules — Modules actifs
JSON /api/v1/openapi.json — Spec publique
SEEN
Présence joueur
Statut en ligne, serveur courant, première et dernière connexion.
TOP
Classements
Argent, Paws, Kills, Morts, Blocs posés/cassés — positions et scores publics.
HDV
Hôtel des Ventes
Annonces en direct, vendeurs, quantités, statistiques.
SERVER
ServerInfo
Joueurs en ligne en temps réel, répartition par serveur.
Pagination et cache
limit
Nombre de résultats à retourner. Les limites exactes dépendent du module.
offset
Décalage pour paginer sans changer le format des réponses.
q
Recherche texte quand le module le supporte.
cache
Les modules coûteux (classements, HDV) sont servis depuis un cache mémoire de quelques secondes.
Seen
Présence publique d'un joueur : statut en ligne, serveur courant si connu, première et dernière activité.
GET /api/v1/module/seen/players/{name} Exemple avec _Koodaa_Champs utiles
online
Statut de connexion public.
onlineServer
Serveur courant si connecté.
firstSeenAt
Première connexion connue.
lastSeenAt
Dernière activité connue.
Classements
Boards publiques, positions, scores bruts et scores formatés.
GET /api/v1/module/leaderboard/boards Liste des boards. Paramètres : q, offset, limit. GET /api/v1/module/leaderboard/boards/{id}/entries Top joueurs. Exemple : "money" GET /api/v1/module/leaderboard/stats Statistiques des classementsBoards disponibles
money
Solde de la monnaie principale.
paws
Solde de la monnaie secondaire "Paws".
kills / deaths
Éliminations et morts.
blocks_placed / blocks_broken
Blocs posés et cassés.
Hôtel des Ventes
Annonces en direct, statistiques publiques de l'HDV.
GET /api/v1/module/hdv/items Liste des annonces. Paramètres : q, seller, sort, offset, limit. GET /api/v1/module/hdv/stats Statistiques globales du moduleExemples
GET /api/v1/module/hdv/items?q=diamond&sort=price_asc&limit=25
Champs utiles
item
Nom affiché de l'objet en vente.
price
Prix demandé par le vendeur.
seller
Pseudo du vendeur.
expiresAt
Date d'expiration de l'annonce.
ServerInfo
Lecture en temps réel des joueurs en ligne sur le réseau (via Redis).
GET /api/v1/module/serverinfo/online Total en ligne + répartition par serveurExemple d'intégration
fetch('https://api.vulpinemc.fr/api/v1/module/serverinfo/online')
.then(r => r.json())
.then(json => console.log(json.data));