Arcane / Public APIAPI publique
v1 · stable
Documentation/Pour commencer

API publique Arcane

Une API HTTP/JSON orientée lecture qui expose les profils joueurs, les classements, les statistiques globales et les données des contributeurs du réseau Minecraft Arcane. Aucune clé n'est requise pour la surface publique.

De quoi s'agit-il

Le réseau Arcane fait tourner un serveur Minecraft Java derrière un proxy Velocity avec plusieurs modes de jeu — Rush, League, Arène PvP, HikaBrain, FreeCube et un Clicker saisonnier. L'état de jeu est persisté dans une base relationnelle puis projeté via une API JSON consommée par le site web et les clients en jeu.

Cette documentation couvre cette API telle qu'observée depuis l'internet public. Ce sont les mêmes données que le site officiel affiche — rien ici n'exige d'accès privilégié.

Conventions de conception

  • JSON partout. Chaque réponse est en application/json; charset=utf-8, erreurs incluses.
  • Champs en snake_case. Quel que soit le langage du service sous-jacent, le format réseau reste du snake_case.
  • Horodatages en millisecondes Unix. premier_join et dernier_join sont des entiers en millisecondes epoch — pas en secondes, pas en ISO 8601.
  • Durées en secondes. Tout champ finissant par _temps_secondes est une durée en secondes.
  • Collections enveloppées. Les endpoints de liste renvoient {"data": [...]} plus les métadonnées de pagination, jamais un tableau nu.
  • Vocabulaire métier français. niveau, morts, parties, victoires, arcanites pour la monnaie premium.

Démarrage rapide

# vérification de l'état
curl https://api.arcanemc.eu/api/health

# un joueur, à sa position de page
curl "https://api.arcanemc.eu/api/players?limit=1"

# tête du classement
curl "https://api.arcanemc.eu/api/leaderboard?limit=10"