APIEndpoints
Server
The server's identity and live status.
Returns the identity and live status of the server your key belongs to — a quick way to check that the key works and the server is reachable.
Endpoint
GET https://api.wardencore.ru/v1/server
Authorization
Requires the server:read scope. A key without it gets 403 insufficient_scope.
GET /v1/server HTTP/1.1
Host: api.wardencore.ru
Authorization: Bearer wc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxResponse
200 OK — application/json:
{
"server_id": "clx9f2c…",
"name": "My SCUM Server",
"online": true,
"player_count": 12,
"mod_version": "2.0.99"
}| Field | Type | Description |
|---|---|---|
server_id | string | The server's stable identifier (the key is bound to this server). |
name | string | null | The display name set in the panel. null if none is set. |
online | boolean | Always true in a 200 response — see below. |
player_count | integer | null | Players currently online. null if the mod does not report it. |
mod_version | string | null | The running WardenCore mod version (e.g. 2.0.99). |
Live status
This endpoint proxies to the WardenCore mod on your server over its live
connection. If the server is offline it returns 503 server_unavailable
(with Retry-After) rather than online: false — so a 200 response always
means the server is reachable. See Server availability.
Errors
Standard error envelope. The ones you're most likely to hit:
| Code | Status | When |
|---|---|---|
unauthorized | 401 | Missing, malformed, expired, or revoked key. |
insufficient_scope | 403 | The key lacks server:read. |
server_unavailable | 503 | The game server is offline or unreachable. |
gateway_timeout | 504 | The server did not respond in time. |