Développeurs

01 · Introduction

Bien démarrer

1

Demande une clé en présentant ton projet, en bas de cette page.

2

Attends la validation de l’équipe, puis copie ta clé (elle ne s’affiche qu’une fois).

3

Appelle l’API depuis ton serveur, avec la clé dans l’en-tête X-API-Key.

URL de base
https://api.redstonia.com/v1

Serveurs

Le paramètre {serveur} des routes prend l’un de ces identifiants, toujours en minuscules. La liste à jour est aussi renvoyée par GET /servers.

Identifiant	Serveur
`aqua`	Aqua

Conventions

Format	JSON en UTF-8. Uniquement des lectures (`GET`).
Dates	ISO 8601 en UTC, par exemple `2026-11-01T10:20:00.000Z`. Les jours seuls sont au format `AAAA-MM-JJ`.
Valeur inconnue	`null` veut dire « inconnu » ou « absent », jamais zéro.
Argent	En $ du jeu, sauf pour les entreprises : en centimes (`1100` = 11,00 $).
Durées	Un objet `{ "seconds", "hours", "text" }`, par exemple `"2j 3h 0min"`.
Joueurs	Par pseudo (lettres, chiffres, `_`) ou par UUID, avec ou sans tirets.
Pagination	Les listes paginées prennent `limit` et `page` ; la réponse indique `total` et `page`.

02 · Sécurité

Authentification

Chaque requête porte ta clé dans l’en-tête X-API-Key. Une clé publique commence par redapi_ (les clés plus anciennes, en rsk_live_, restent valables) et donne accès en lecture à toutes les routes de cette page, sur tous les serveurs.

curl "https://api.redstonia.com/v1/players/Kynox" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

const res = await fetch('https://api.redstonia.com/v1/players/Kynox', {
  headers: { 'X-API-Key': process.env.REDSTONIA_API_KEY },
});
if (!res.ok) throw new Error((await res.json()).message);
const player = await res.json();
console.log(player.name, player.grade?.label);

import os, requests

res = requests.get(
    'https://api.redstonia.com/v1/players/Kynox',
    headers={'X-API-Key': os.environ['REDSTONIA_API_KEY']},
    timeout=10,
)
res.raise_for_status()
print(res.json()['name'])

$ch = curl_init('https://api.redstonia.com/v1/players/Kynox');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('REDSTONIA_API_KEY')],
]);
$player = json_decode(curl_exec($ch), true);
echo $player['name'];

Ta clé doit rester côté serveur : jamais dans une page web, une extension, un mod ou une application mobile, où n’importe qui pourrait la lire. Range-la dans une variable d’environnement, pas dans ton dépôt de code. Si elle a fuité, demande-en une nouvelle.

03 · Ressource

Joueurs

Rechercher un joueur, voir qui est en ligne et consulter un profil public.

GET /players?search={pseudo} Rechercher des joueurs

Rechercher des joueurs. Les joueurs dont le pseudo commence par le texte donné, du plus récemment vu au plus ancien.

Paramètre	Par défaut	Valeurs
`search`	requis	2 à 16 caractères : lettres, chiffres, _
`limit`	20	de 1 à 50

Requête

curl "https://api.redstonia.com/v1/players?search=Kyn" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "players": [
    { "uuid": "87a760e3-fdf0-3a57-af7e-8fe0b8c0e2a1", "name": "Kynox", "lastSeen": "2026-10-31T21:14:05.000Z" }
  ]
}

GET /players/online Joueurs en ligne

Joueurs en ligne. Tous les joueurs connectés en ce moment, sur tous les serveurs.

Requête

curl "https://api.redstonia.com/v1/players/online" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "total": 1,
  "players": [
    {
      "uuid": "87a760e3-fdf0-3a57-af7e-8fe0b8c0e2a1",
      "name": "Kynox",
      "server": "aqua",
      "grade": { "id": "player", "label": "Joueur", "weight": 0, "staff": false },
      "country": "France"
    }
  ]
}

GET /players/{pseudo-ou-uuid} Profil public d’un joueur

Profil public d’un joueur. Grade, temps de jeu, dernière connexion et, pour chaque serveur : argent, pays, power, kills et morts. L’UUID est accepté avec ou sans tirets.

Requête

curl "https://api.redstonia.com/v1/players/Kynox" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "uuid": "87a760e3-fdf0-3a57-af7e-8fe0b8c0e2a1",
  "name": "Kynox",
  "online": false,
  "server": null,
  "avatar": "https://mc-heads.net/avatar/87a760e3-fdf0-3a57-af7e-8fe0b8c0e2a1/64",
  "grade": { "id": "player", "label": "Joueur", "weight": 0, "staff": false },
  "firstSeen": "2026-09-28T16:02:11.000Z",
  "lastLogin": "2026-10-31T19:40:00.000Z",
  "lastSeen": "2026-10-31T21:14:05.000Z",
  "lastServer": "aqua",
  "playtime": {
    "total": { "seconds": 183600, "hours": 51, "text": "2j 3h 0min" },
    "servers": { "aqua": { "seconds": 183600, "hours": 51, "text": "2j 3h 0min" } }
  },
  "servers": {
    "aqua": {
      "online": false,
      "money": 15420,
      "grade": { "id": "player", "label": "Joueur", "weight": 0, "staff": false },
      "country": { "id": "24", "tag": "France", "code": "fr", "role": { "id": "leader", "label": "Chef" } },
      "power": 10, "powerMax": 10, "kills": 12, "deaths": 4, "ratio": 3,
      "playtime": { "seconds": 183600, "hours": 51, "text": "2j 3h 0min" },
      "lastLogin": "2026-10-31T19:40:00.000Z",
      "lastSeen": "2026-10-31T21:14:05.000Z"
    }
  }
}

GET /rankings/{serveur}/players Classement des joueurs

Classement des joueurs. Les meilleurs joueurs d’un serveur. Avec all à la place du serveur : classement de tout le réseau, seulement par temps de jeu ou par kills.

Paramètre	Par défaut	Valeurs
`by`	money	money, playtime, power ou kills
`limit`	10	de 1 à 100

Requête

curl "https://api.redstonia.com/v1/rankings/aqua/players?by=kills&limit=3" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "server": "aqua",
  "by": "kills",
  "ranking": [
    { "position": 1, "uuid": "87a760e3-fdf0-3a57-af7e-8fe0b8c0e2a1", "name": "Kynox", "country": "France", "value": 12 }
  ]
}

04 · Ressource

Pays

Les pays de chaque serveur, leurs membres, leurs notes et leurs classements.

GET /countries/{serveur} Lister les pays

Lister les pays. Tous les pays d’un serveur, triés et paginés. Les notes sont sur 20.

Paramètre	Par défaut	Valeurs
`sort`	rank	rank, power, level, claims, members, bank, activite, economie, militaire, architecture, name, age ou elo
`search`	-	partie du nom du pays
`limit`	100	de 1 à 250
`page`	1	numéro de page

Requête

curl "https://api.redstonia.com/v1/countries/aqua?sort=power&limit=2" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "server": "aqua",
  "sort": "power",
  "total": 4,
  "page": 1,
  "countries": [
    {
      "id": "24", "server": "aqua", "name": "France", "code": "fr", "empire": false,
      "level": 3, "power": 10, "powerMax": 20, "claims": 42, "members": 2, "online": 1,
      "leader": { "uuid": "87a760e3-fdf0-3a57-af7e-8fe0b8c0e2a1", "name": "Kynox" },
      "foundedAt": "2026-10-17T16:10:16.746Z",
      "open": false, "forSale": false, "salePrice": null, "bank": 250000,
      "notes": { "activite": 16.6, "economie": 4, "militaire": 10, "architecture": 12.5, "globale": 10.8 },
      "rank": { "position": 1, "total": 4 },
      "elo": 1000,
      "updatedAt": "2026-11-01T10:20:00.000Z"
    }
  ]
}

GET /countries/{serveur}/{pays} Consulter un pays

Consulter un pays. La fiche complète d’un pays, désigné par son identifiant ou par son nom : description, membres avec leur rôle, et l’historique de ses notes sur 30 jours.

Requête

curl "https://api.redstonia.com/v1/countries/aqua/France" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "id": "24", "server": "aqua", "name": "France", "code": "fr",
  "description": "Le pays des bâtisseurs.",
  "level": 3, "power": 10, "powerMax": 20, "claims": 42, "members": 2, "online": 1,
  "leader": { "uuid": "87a760e3-fdf0-3a57-af7e-8fe0b8c0e2a1", "name": "Kynox" },
  "bank": 250000,
  "notes": { "activite": 16.6, "economie": 4, "militaire": 10, "architecture": 12.5, "globale": 10.8 },
  "rank": { "position": 1, "total": 4 },
  "memberList": [
    {
      "uuid": "87a760e3-fdf0-3a57-af7e-8fe0b8c0e2a1", "name": "Kynox",
      "role": { "id": "leader", "label": "Chef" },
      "grade": { "id": "player", "label": "Joueur", "weight": 0, "staff": false },
      "online": true, "power": 10, "powerMax": 10, "kills": 12, "deaths": 4,
      "lastLogin": "2026-10-31T19:40:00.000Z"
    }
  ],
  "notesHistory": [
    { "day": "2026-11-01", "activite": 16.6, "economie": 4, "militaire": 10, "architecture": 12.5, "globale": 10.8, "rank": 1 }
  ]
}

GET /rankings/{serveur}/countries Classement des pays

Classement des pays. Le haut du classement d’un serveur, selon le critère choisi.

Paramètre	Par défaut	Valeurs
`by`	rank	mêmes valeurs que sort dans « Lister les pays »
`limit`	10	de 1 à 100

Requête

curl "https://api.redstonia.com/v1/rankings/aqua/countries?limit=3" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "server": "aqua",
  "by": "rank",
  "ranking": [
    {
      "position": 1, "id": "24", "name": "France", "code": "fr", "rank": 1,
      "notes": { "globale": 10.8 }, "power": 10, "level": 3, "claims": 42, "members": 2, "bank": 250000
    }
  ]
}

05 · Ressource

Entreprises

Les entreprises cotées ou non, leur cours, et ce que tout joueur voit en jeu : paris, prêts, chantiers. Tous les montants sont en centimes (1100 = 11,00 $).

GET /business/{serveur} Lister les entreprises

Lister les entreprises. Les entreprises actives, avec leur cours, leur variation sur 24 h, leur capitalisation et leurs actions. Aucune trésorerie ni aucun résultat n’est public.

Paramètre	Par défaut	Valeurs
`sort`	cap	cap, change, volume, price ou name
`sector`	-	un secteur (ex. AGRICULTURE)
`listed`	-	1 : seulement les entreprises cotées

Requête

curl "https://api.redstonia.com/v1/business/aqua?listed=1" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "server": "aqua",
  "sort": "cap",
  "updatedAt": "2026-11-01T10:20:00.000Z",
  "totals": { "trades24h": 0, "volume24h": 0, "activeLoans": 0, "energySites": 0, "casinoTables": 0, "silos": 1 },
  "companies": [
    {
      "id": "AGRI", "name": "RedAgri", "sector": { "id": "AGRICULTURE", "label": "Agriculture" },
      "description": "Agriculture", "emblem": "minecraft:bread", "status": "ACTIVE",
      "listed": true, "halted": false, "founder": "Dracky07", "country": "Danemark",
      "createdAt": "2026-10-18T09:49:52.902Z",
      "price": 1000, "reference": 1000, "change24h": 0, "marketCap": 1000000,
      "volume24h": 0, "value24h": 0, "shares": 1000, "available": 400,
      "bestBid": 0, "bestAsk": 1000, "holders": 2,
      "chart24h": [1000, 1000, 1000],
      "updatedAt": "2026-11-01T10:20:00.000Z"
    }
  ]
}

GET /business/{serveur}/companies/{id} Consulter une entreprise

Consulter une entreprise. La fiche d’une entreprise (mêmes champs que dans la liste) et ses cours de clôture jour par jour.

Paramètre	Par défaut	Valeurs
`days`	90	nombre de jours d’historique, de 1 à 365

Requête

curl "https://api.redstonia.com/v1/business/aqua/companies/AGRA?days=7" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "id": "AGRA", "name": "agriaqua", "price": 1000, "change24h": 0, "marketCap": 1000000,
  "history": [
    { "day": "2026-10-31", "close": 1000, "volume": 0 },
    { "day": "2026-11-01", "close": 1000, "volume": 0 }
  ]
}

GET /business/{serveur}/events Paris ouverts

Paris ouverts. Les événements sur lesquels on peut parier : issues, cotes et mises par issue.

Requête

curl "https://api.redstonia.com/v1/business/aqua/events" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{ "server": "aqua", "updatedAt": "2026-11-01T10:20:00.000Z", "events": [] }

GET /business/{serveur}/loans Offres de prêt

Offres de prêt. Les prêts proposés par les entreprises : taux par période, échéance et coût total d’exemple.

Requête

curl "https://api.redstonia.com/v1/business/aqua/loans" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{ "server": "aqua", "updatedAt": "2026-11-01T10:20:00.000Z", "loans": [] }

GET /business/{serveur}/jobs Chantiers ouverts

Chantiers ouverts. Les chantiers de construction ouverts aux devis.

Requête

curl "https://api.redstonia.com/v1/business/aqua/jobs" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{ "server": "aqua", "updatedAt": "2026-11-01T10:20:00.000Z", "jobs": [] }

06 · Ressource

Serveurs

L’état des serveurs en direct et les chiffres du réseau.

GET /servers Tous les serveurs

Tous les serveurs. Chaque serveur : en ligne ou non, joueurs connectés, version, latence et record de joueurs.

Requête

curl "https://api.redstonia.com/v1/servers" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "totalPlayers": 12,
  "servers": [
    {
      "id": "aqua", "name": "Aqua", "online": true, "players": 12, "maxPlayers": 200,
      "version": "1.20.1", "latency": 3,
      "plugin": { "connected": true, "lastHeartbeat": "2026-11-01T10:21:30.000Z" },
      "peak": { "players": 34, "at": "2026-10-25T20:12:00.000Z" },
      "queue": { "waiting": 0, "priority": 0, "open": true, "freeSlots": 188, "online": 12, "maxPlayers": 200, "reservedSlots": 0 }
    }
  ]
}

GET /servers/{serveur} Détails d’un serveur

Détails d’un serveur. Les mêmes informations pour un seul serveur, avec la liste des joueurs connectés.

Requête

curl "https://api.redstonia.com/v1/servers/aqua" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "id": "aqua", "name": "Aqua", "online": true, "players": 1, "maxPlayers": 200,
  "onlinePlayers": [
    {
      "uuid": "87a760e3-fdf0-3a57-af7e-8fe0b8c0e2a1", "name": "Kynox",
      "grade": { "id": "player", "label": "Joueur", "weight": 0, "staff": false },
      "country": "France"
    }
  ]
}

GET /stats Statistiques du réseau

Statistiques du réseau. Joueurs en ligne, nombre de joueurs connus, pays par serveur, ventes de l’hôtel des ventes sur 24 h.

Requête

curl "https://api.redstonia.com/v1/stats" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "online": 12,
  "servers": { "aqua": { "online": true, "players": 12 } },
  "players": 1840,
  "countries": { "aqua": 4 },
  "hdv24h": { "sales": 37, "volume": 482000 },
  "sanctions": 96
}

07 · Ressource

Guerres

Les guerres entre pays : en cours, terminées, scores et récompenses.

GET /wars/{serveur} Lister les guerres

Lister les guerres. Les guerres du serveur, celles en cours d’abord puis les plus récentes.

Paramètre	Par défaut	Valeurs
`state`	toutes	ongoing (en cours) ou ended (terminées)
`page`	1	page de résultats
`limit`	50	de 1 à 100

Requête

curl "https://api.redstonia.com/v1/wars/aqua?state=ended&limit=1" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "server": "aqua",
  "total": 6,
  "page": 1,
  "wars": [
    {
      "id": "b30c4f46-3d52-4266-9ffd-8621ceb74236",
      "server": "aqua",
      "reason": "Conquête du nord",
      "state": "ended",
      "startedAt": "2026-10-21T17:58:27.532Z",
      "endsAt": "2026-10-28T17:58:27.532Z",
      "endedAt": "2026-10-23T09:40:30.621Z",
      "remaining": null,
      "declarer": { "id": "34", "name": "Danemark", "code": "dk", "kills": 3, "victories": 1, "warPoints": 40, "progress": 16 },
      "target": { "id": "25", "name": "Allemagne", "code": "de", "kills": 9, "victories": 4, "warPoints": 250, "progress": 100 },
      "result": { "type": "victory", "winner": "Allemagne", "winnerId": "25" },
      "rewards": { "money": 5, "power": 5, "elo": 16 }
    }
  ]
}

GET /wars/{serveur}/{id} Consulter une guerre

Consulter une guerre. Une guerre par son identifiant, avec le détail des scores des deux camps.

Requête

curl "https://api.redstonia.com/v1/wars/aqua/b30c4f46-3d52-4266-9ffd-8621ceb74236" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "id": "b30c4f46-3d52-4266-9ffd-8621ceb74236",
  "server": "aqua",
  "state": "ended",
  "declarer": { "id": "34", "name": "Danemark", "code": "dk", "warPoints": 40, "progress": 16 },
  "target": { "id": "25", "name": "Allemagne", "code": "de", "warPoints": 250, "progress": 100 },
  "result": { "type": "victory", "winner": "Allemagne", "winnerId": "25" }
}

GET /countries/{serveur}/{pays}/wars Guerres d’un pays

Guerres d’un pays. Le bilan d’un pays (guerres, victoires, défaites, nuls) et la liste de ses guerres.

Paramètre	Par défaut	Valeurs
`page`	1	page de résultats

Requête

curl "https://api.redstonia.com/v1/countries/aqua/Allemagne/wars" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "server": "aqua",
  "country": { "id": "25", "name": "Allemagne", "code": "de", "elo": 1016 },
  "totals": { "wars": 3, "ongoing": 0, "won": 2, "lost": 1, "draws": 0 },
  "page": 1,
  "wars": [ { "id": "b30c4f46-3d52-4266-9ffd-8621ceb74236", "state": "ended", "result": { "type": "victory", "winner": "Allemagne" } } ]
}

08 · Ressource

Hôtel des ventes

Les ventes, les annonces en cours et les prix du marché.

GET /hdv/{serveur}/sales Dernières ventes

Dernières ventes. Les ventes conclues, les plus récentes d’abord. Filtrables par objet ou par joueur (vendeur ou acheteur).

Paramètre	Par défaut	Valeurs
`item`	-	ex. : minecraft:diamond
`player`	-	pseudo ou UUID
`page`	1	page de résultats
`limit`	50	de 1 à 100

Requête

curl "https://api.redstonia.com/v1/hdv/aqua/sales?limit=2" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "server": "aqua",
  "page": 1,
  "sales": [
    {
      "id": 21,
      "server": "aqua",
      "item": { "key": "minecraft:leather", "id": "minecraft:leather", "customName": null, "enchanted": false },
      "quantity": 64,
      "unitPrice": 5,
      "total": 320,
      "negotiated": false,
      "seller": { "uuid": "f9c954af-fe91-38dc-87f3-d669b944b10c", "name": "Marchand" },
      "buyer": { "uuid": "f37d6b1e-8f3b-3ffb-ac25-432ce813dfb0", "name": "Kynox" },
      "soldAt": "2026-11-01T02:51:37.476Z"
    }
  ]
}

GET /hdv/{serveur}/listings Annonces en cours

Annonces en cours. Les objets en vente en ce moment, du moins cher au plus cher (ou les plus récents avec sort=recent).

Paramètre	Par défaut	Valeurs
`item`	-	ex. : minecraft:diamond
`seller`	-	pseudo ou UUID
`sort`	prix	recent
`page`	1	page de résultats

Requête

curl "https://api.redstonia.com/v1/hdv/aqua/listings?limit=2" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "server": "aqua",
  "page": 1,
  "listings": [
    {
      "id": 67,
      "item": { "key": "minecraft:cooked_beef", "id": "minecraft:cooked_beef", "customName": null, "enchanted": false },
      "quantity": 64,
      "unitPrice": 8,
      "total": 512,
      "negotiable": false,
      "seller": { "uuid": "94cc3172-b6d4-35c4-a41f-d29bf7ef5c4b", "name": "Kynox" },
      "expiresAt": "2026-11-02T15:35:18.504Z"
    }
  ]
}

GET /hdv/{serveur}/items Objets les plus échangés

Objets les plus échangés. Les objets classés par volume vendu sur la période, avec leurs prix minimum, maximum et moyen.

Paramètre	Par défaut	Valeurs
`days`	7	de 1 à 365
`limit`	50	de 1 à 200

Requête

curl "https://api.redstonia.com/v1/hdv/aqua/items?limit=2" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "server": "aqua",
  "days": 7,
  "items": [
    { "key": "minecraft:leather", "id": "minecraft:leather", "customName": null, "sales": 4, "quantity": 256, "volume": 1984, "price": { "min": 5, "max": 9, "average": 8 } }
  ]
}

GET /hdv/{serveur}/item?key={objet} Cours d’un objet

Cours d’un objet. Les ventes d’un objet sur la période, son prix le plus bas en vente, le stock disponible et l’historique jour par jour.

Paramètre	Par défaut	Valeurs
`key`	requis	ex. : minecraft:diamond
`days`	30	de 1 à 365

Requête

curl "https://api.redstonia.com/v1/hdv/aqua/item?key=minecraft:leather" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "server": "aqua",
  "key": "minecraft:leather",
  "days": 30,
  "sales": 4,
  "quantity": 256,
  "volume": 1984,
  "price": { "min": 5, "max": 9, "average": 8 },
  "market": { "lowest": 7, "stock": 128 },
  "history": [ { "day": "2026-11-01", "quantity": 256, "average": 8 } ]
}

09 · Ressource

Notations

Le classement hebdomadaire des pays, publié chaque lundi à midi.

GET /notations/{serveur} Classement de la semaine

Classement de la semaine. Les notes des pays (activité, économie, militaire, architecture) et leur bourse. « all » mélange tous les serveurs ; week choisit une semaine passée.

Paramètre	Par défaut	Valeurs
`week`	la dernière	une date de la semaine, AAAA-MM-JJ

Requête

curl "https://api.redstonia.com/v1/notations/aqua" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "server": "aqua",
  "week": { "number": 44, "start": "2026-10-26", "end": "2026-11-01", "current": true, "publishedAt": "2026-10-26T12:03:12.193Z" },
  "previous": "2026-10-19",
  "next": null,
  "countries": [
    {
      "position": 1,
      "server": "aqua",
      "id": "48",
      "name": "Canada",
      "code": "ca",
      "notes": { "activite": 20, "economie": 20, "militaire": 12.4, "architecture": 17.7, "globale": 17.5 },
      "bourse": 49088.3,
      "bank": 0,
      "bankDelta": null
    }
  ]
}

10 · Ressource

Warzones

Les zones de combat : qui les tient, depuis quand, et le classement des pays.

GET /warzones/{serveur} État des warzones

État des warzones. Chaque zone avec son pays tenant, son contrôle, son gain par minute ; les règles du jour et les classements (général et par zone). Mis à jour toutes les 30 secondes.

Requête

curl "https://api.redstonia.com/v1/warzones/aqua" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "server": "aqua",
  "updatedAt": "2026-11-01T18:05:46.540Z",
  "zones": [
    {
      "id": "mine",
      "title": "Zone Mine",
      "description": "Rapportez 60$ / minute en contrôlant cette zone minière.",
      "owner": { "tag": "Pays-Bas" },
      "percent": 100,
      "contested": false,
      "heldSeconds": 24005,
      "reward": 60,
      "unit": "money"
    }
  ],
  "rules": { "moneyCap": 10000, "powerCap": 200, "prize": 5000, "reset": "10h", "secondsUntilReset": 53653 },
  "boards": {
    "global": [ { "id": "56", "tag": "Pays-Bas", "points": 692 } ],
    "mine": [ { "id": "56", "tag": "Pays-Bas", "points": 395 } ]
  }
}

11 · Ressource

Jeux

La boutique du serveur (/shop) et les succès (/succes).

GET /jeux/{serveur} Boutique et succès

Boutique et succès. Les cours de la boutique (prix de base et prix du moment) et la liste des succès avec leurs paliers. Les succès secrets ne sont pas listés.

Requête

curl "https://api.redstonia.com/v1/jeux/aqua" \
  -H "X-API-Key: $REDSTONIA_API_KEY"

Réponse · 200, valeurs d’exemple

{
  "server": "aqua",
  "updatedAt": "2026-11-01T18:05:55.811Z",
  "shop": {
    "categories": [ { "id": "minerais", "name": "Minerais" } ],
    "items": [ { "item": "minecraft:coal", "category": "minerais", "base": 50, "price": 50, "stack": 3198 } ]
  },
  "achievements": [
    {
      "id": "temps_de_jeu",
      "category": "aventure",
      "group": "Parcours",
      "name": "Habitant",
      "description": "Passer du temps sur Redstonia (en minutes).",
      "tiers": [ { "goal": 60, "reward": 1000 }, { "goal": 600, "reward": 5000 } ]
    }
  ]
}

07 · Réponses

Limites et erreurs

Limite de requêtes

120 requêtes par minute par clé (l’équipe peut relever la limite d’un projet qui en a besoin). Les en-têtes x-ratelimit-limit, x-ratelimit-remaining et x-ratelimit-reset indiquent où tu en es. Au-delà, l’API répond 429 avec un en-tête retry-after : attends ce nombre de secondes avant de réessayer.

Format des erreurs

Toutes les erreurs ont la même forme. Base ton code sur error : le message, en français, peut changer.

{
  "statusCode": 404,
  "error": "not_found",
  "message": "Joueur introuvable : Kynox."
}

HTTP	error	Cause
`400`	`bad_request`	Paramètre manquant ou invalide (pseudo mal formé, search trop court…).
`401`	`api_key_missing`	Aucune clé : ajoute l’en-tête X-API-Key.
`401`	`api_key_invalid`	Clé inconnue ou désactivée.
`403`	`reserved_endpoint`	Route réservée aux services officiels de Redstonia.
`404`	`not_found`	Joueur, pays, entreprise ou serveur introuvable, ou route inconnue.
`429`	`too_many_requests`	Limite de requêtes atteinte : attends avant de réessayer.
`500`	`internal_error`	Erreur de notre côté : réessaie plus tard, et signale-la si elle dure.

08 · Usage

Bonnes pratiques

Mets les réponses en cache
Les données changent toutes les quelques secondes à quelques minutes : inutile de redemander la même chose à chaque visite.
Garde ta clé secrète
Appelle l’API depuis ton serveur, puis sers tes propres données à tes visiteurs.
Respecte la limite
En cas de 429, attends la durée indiquée au lieu de réessayer en boucle.
Pas d’abus
Une utilisation abusive peut entraîner la désactivation immédiate de la clé.

09 · Accès

Obtenir une clé publique

Présente ton projet. L’équipe vérifie qu’il respecte les règles et n’utilise que les données publiques, puis ta clé apparaît ici, une seule fois.

Se connecter pour faire une demande