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
- Adresse de base :
https://runheim.fr/api/v1/ - GET uniquement. Toute autre méthode renvoie
405. - Réponses en
application/json, mises en cache 45 secondes côté serveur et côté CDN (Cache-Control: public, max-age=45). - Limite de requêtes par adresse IP (réponse
429au-delà) : reste raisonnable, une lecture toutes les 30 secondes suffit largement. - Aucune donnée personnelle : jamais d’adresse IP de joueur, d’e-mail, de mot de passe, de clé, de chemin de fichier ou de log brut. Les classements ne contiennent que des pseudos.
- En cas d’erreur, le corps est un objet JSON
{"erreur": "…"}avec un code HTTP adapté (404,405,429).
Les points d’entrée
| Point d’entrée | Ce qu’il renvoie |
|---|---|
GET /api/v1/statut | Chaque serveur du réseau : en ligne ou non, nombre de joueurs, joueurs max, et les pseudos actuellement connectés. |
GET /api/v1/version | Versions 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/nouveautes | Les dernières nouveautés de Runheim (date, titre, texte), de la plus récente à la plus ancienne. |
GET /api/v1/annonces | Les annonces actuellement affichées en jeu (texte et serveurs concernés). |
GET /api/v1/classements | Top 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.