Runheim
Pour les développeurs

L’API publique de Runheim

Une API en lecture seule qui expose le statut du réseau, les versions, les nouveautés, les annonces et les classements — en JSON, gratuitement, sans clé.

Les règles simples

Les points d’entrée

Point d’entréeCe qu’il renvoie
GET /api/v1/statutChaque serveur du réseau : en ligne ou non, nombre de joueurs, joueurs max, et les pseudos actuellement connectés.
GET /api/v1/versionVersions du mod et du launcher, empreintes SHA-256 et liens de téléchargement, plus la version de Minecraft/Forge et l’adresse du serveur.
GET /api/v1/nouveautesLes dernières nouveautés de Runheim (date, titre, texte), de la plus récente à la plus ancienne.
GET /api/v1/annoncesLes annonces actuellement affichées en jeu (texte et serveurs concernés).
GET /api/v1/classementsTop factions et top niveaux de minage, en pseudos seulement, plus les joueurs en ligne.

Exemples

Statut du réseau

curl https://runheim.fr/api/v1/statut
{
  "heure": "2026-11-22T15:00:00.000Z",
  "joueurs": 3,
  "serveurs": {
    "faction": { "nom": "Faction", "enLigne": true, "joueurs": 2, "max": 210, "pseudos": ["Dehks01", "…"] },
    "minage1": { "nom": "Minage 1", "enLigne": true, "joueurs": 1, "max": 160, "pseudos": ["…"] },
    "proxy":   { "nom": "Proxy",   "enLigne": true, "joueurs": 3, "max": 1000, "pseudos": [] }
  }
}

Versions (utile pour un launcher)

curl https://runheim.fr/api/v1/version
{
  "minecraft": "26.1.2", "forge": "26.1.2-64.1.5", "adresse": "play.runheim.fr",
  "mod":     { "nom": "Runheim", "version": "1.7.41", "sha256": "…", "telechargement": "https://runheim.fr/launcher/valkoria-mod.jar" },
  "launcher": { "nom": "Valkoria", "version": "0.1.0", "sha256": { "windows": "…", "linux": "…" },
                "telechargements": { "windows": "https://runheim.fr/launcher/Valkoria.exe",
                                     "linux": "https://runheim.fr/launcher/Valkoria-linux" } }
}

Le launcher de Runheim lit ce point d’entrée pour savoir s’il doit se mettre à jour : compare mod.version et launcher.version avec ta version, et vérifie l’empreinte SHA-256 du fichier téléchargé.

Nouveautés, annonces, classements

curl https://runheim.fr/api/v1/nouveautes
curl https://runheim.fr/api/v1/annonces
curl https://runheim.fr/api/v1/classements
// classements, par exemple :
{
  "heure": "…",
  "factions": [ { "nom": "…", "xp": 1200, "claims": 34, "membres": 5 } ],
  "minage":   [ { "nom": "…", "xp": 5400 } ],
  "enLigne":  [ { "nom": "…", "serveur": "Faction" } ]
}

Depuis ton propre site

Depuis une page servie sur runheim.fr, un simple appel relatif suffit (même origine, donc pas de configuration CORS) :

fetch("/api/v1/statut").then(r => r.json()).then(d => {
  console.log(d.joueurs + " joueur(s) en ligne");
});

Prévois toujours un repli propre si l’API ne répond pas (message sobre, comme le fait la page d’accueil de ce site).

Ce qui n’existe pas ici

Cette API est strictement en lecture seule : aucune écriture, aucune action sur les serveurs, aucune donnée de compte. Il n’y a pas d’API d’administration publique — l’administration du réseau passe par le panneau privé de l’équipe.