A game is pinned to exactly one node — its players, rooms and leaderboards exist only there. Resolve the node once, then point every call at it; a key presented on the wrong node answers 421 with a home_api_url hint.
async function discoverNodes(options = {})
GET /api/discover.php — every enabled node plus the server's geo hint. No auth needed.
Example Usage:
const { nodes } = await discoverNodes();
async function resolveGameNode(apiKey, options = {})
POST /api/discover.php with the key in X-Api-Token (never in a URL) — returns the game's pinned node.
Example Usage:
const { region, node } = await resolveGameNode(apiKey);
const home = new MultiplayerClient(apiKey, { baseUrl: node.api_url });