Kryeit Spectrum API
A public REST API for the Kryeit Minecraft server. All endpoints are free to use, require no authentication, and return JSON. CORS is enabled so you can call from any browser or application.
No auth required
All public endpoints work without any API key or token.
CORS enabled
Call from any origin — browser, bot, AI, or server.
Always JSON
All responses are
application/json.Server
GET
/api/server
Current TPS, player count, online status
Returns live server status without any historical data. Cached for 30 seconds.
Response
{
"online": true,
"status": "Online",
"tps": 19.8,
"tpsPercent": 99,
"playerCount": 4,
"updatedAt": 1748812345678
}
GET
/api/online
Who is online + AFK status
Returns every currently online player with their AFK status, how long they've been AFK, and their current session duration.
Response
{
"count": 2,
"players": [
{
"uuid": "4f28b9c5-d3d4-4e37-af7c-fb3b6971dc7d",
"name": "LoeweKarneval83",
"afk": false,
"afkSince": null,
"afkDuration": null,
"joinedAt": 1748810000000,
"sessionDuration": 2345678
}
]
}
GET
/api/events
Latest join/leave events
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| limit | number | optional | Max results, default 50, max 500 |
| type | string | optional | join or leave |
GET /api/events?limit=20&type=join
Response
{
"count": 369,
"events": [
{
"ts": 1748812000000,
"type": "join",
"name": "LoeweKarneval83",
"uuid": "4f28b9c5-..."
}
]
}
GET
/api/sessions
Completed player sessions
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| limit | number | optional | Max results, default 50, max 500 |
| uuid | string | optional | Filter sessions for one player |
GET /api/sessions?uuid=4f28b9c5-d3d4-4e37-af7c-fb3b6971dc7d&limit=10
Response
{
"count": 89,
"sessions": [
{
"uuid": "4f28b9c5-...",
"name": "LoeweKarneval83",
"duration": 5420000,
"durationFormatted": "1h 30m",
"startedAt": 1748800000000,
"endedAt": 1748805420000
}
]
}
Players
GET
/api/players
All known players
Returns all players ever seen on the server with their first join date and new-player status.
{
"count": 41,
"players": [
{
"uuid": "4f28b9c5-...",
"name": "LoeweKarneval83",
"isNew": false,
"firstSeen": 1748700000000,
"avatar": "https://mc-heads.net/avatar/.../32"
}
]
}
GET
/api/player/:uuid
Full player profile + all stats
Returns the full player profile including all 9 stat categories (mined, crafted, used, etc.), session history, and join/leave events. This call fetches from the kryeit.com API in real time so it may take a second.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string | required | Player UUID (with or without dashes) |
GET /api/player/4f28b9c5-d3d4-4e37-af7c-fb3b6971dc7d
Response (abbreviated)
{
"uuid": "4f28b9c5-...",
"name": "LoeweKarneval83",
"discordId": "694245050565263470",
"lastSeen": 1748812000000,
"connected": true,
"firstSeen": 1748700000000,
"stats": {
"minecraft:custom/minecraft:play_time": 12719816,
"minecraft:custom/minecraft:deaths": 42,
"minecraft:mined/minecraft:stone": 18432
},
"sessions": [ /* array of session objects */ ],
"events": [ /* array of join/leave events */ ]
}
GET
/api/playtime/:uuid
Playtime direct from kryeit API
{
"uuid": "4f28b9c5-...",
"name": "LoeweKarneval83",
"ticks": 12719816,
"ms": 635990800,
"formatted": "176h 39m",
"hours": 176.7
}
GET
/api/lastseen/:uuid
Last online time
{
"uuid": "4f28b9c5-...",
"name": "LoeweKarneval83",
"connected": false,
"lastSeenMs": 1748812000000,
"lastSeenISO": "2025-06-01T14:26:40.000Z",
"ago": "2h 14m ago"
}
GET
/api/player/:uuid?stat=X
Look up any single stat
Pass any stat name — the worker tries all 9 categories and returns whatever matches. You can use short names or full keys.
Examples
GET /api/player/4f28b9c5-.../? stat=damage_taken
GET /api/player/4f28b9c5-.../? stat=play_time
GET /api/player/4f28b9c5-.../? stat=stone
GET /api/player/4f28b9c5-.../? stat=minecraft:custom/minecraft:deaths
Note: The worker strips the
minecraft: prefix and tries all stat categories. It always makes one call per category in parallel and returns all matches.Response
{
"selectedStats": {
"minecraft:custom/minecraft:damage_taken": 84210
},
"minecraftName": "LoeweKarneval83",
"connected": false,
"lastSeen": 1748812000000
}
API Panel
The API Panel is a community knowledge base with AI/webhook integration. Entries are submitted by users or AI bots and approved by admins before becoming public.
GET
/api/wiki/categories
All categories
{
"categories": [
{
"id": "abc123",
"name": "Commands",
"slug": "commands",
"icon": "⚙️",
"desc": "Server commands and usage"
}
]
}
GET
/api/wiki/:slug
All entries in a category
The primary endpoint for AI integrations. Returns all approved entries for a given category slug.
GET /api/wiki/commands
Response
{
"category": { "name": "Commands", "slug": "commands" },
"entries": [
{
"id": "xyz789",
"title": "How to use /home",
"body": "Type /home to teleport to your set home...",
"icon": "🏠",
"source": "user",
"ts": 1748800000000
}
]
}
GET
/api/wiki/entries
All approved entries
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| category | string | optional | Filter by category ID |
POST
/api/wiki/webhook
AI/bot entry submission
Allows your AI or bot to submit entries for admin review. Set WIKI_WEBHOOK_SECRET as a Worker env var to protect this endpoint.
Request body
{
"title": "Entry title",
"body": "The entry content.",
"categorySlug": "commands",
"icon": "⚙️",
"author": "MyAI",
"webhookSecret": "YOUR_WEBHOOK_SECRET"
}
Response
{ "ok": true, "message": "Entry submitted for admin review" }
POST
/api/wiki/submit
Public user submission
Submits an entry for admin review. No auth required — all submissions go to pending.
{
"title": "Entry title",
"body": "Content here.",
"categoryId": "abc123",
"icon": "📖"
}