Java SDK — Regions

Regions

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.

Regions.discover
public static DiscoverResponse discover(Client client) throws IOException

GET /api/discover.php — every enabled node plus the server's geo hint. No auth needed.

Example Usage:

DiscoverResponse dir = Regions.discover(client);
Regions.resolveGame
public static GameNodeResponse resolveGame(Client client, String apiKey) throws IOException

POST /api/discover.php with the key in X-Api-Token (never in a URL) — returns the game's pinned node.

Example Usage:

GameNodeResponse r = Regions.resolveGame(client, apiKey);
Client home = new Client(apiKey, "", r.node.api_url);