Files
firefrost-services/cloudflare-workers/servers-api/README.md
Claude 567164ef7d Add servers-api Cloudflare Worker to version control
- Retrieved from Cloudflare dashboard via MCP connector
- Was 'dashboard only, not in any git repo' - gap now closed
- Original creation: April 3, 2026 by Chronicler #56 (The Velocity)
- Proxies Pterodactyl API for live server status on website

Chronicler #68
2026-04-08 05:44:00 +00:00

79 lines
1.8 KiB
Markdown

# Servers API - Cloudflare Worker
**Purpose:** Proxies Pterodactyl Panel API to provide live server status for firefrostgaming.com
**Deployed URL:** https://servers-api.firefrostgaming.workers.dev
**Created:** April 3, 2026 by Chronicler #56 (The Velocity)
**Retrieved from Cloudflare:** April 8, 2026 by Chronicler #68
---
## What It Does
1. Receives request from website (firefrostgaming.com or pages.dev preview)
2. Fetches server list from Pterodactyl Panel API
3. Fetches live resource stats for each server
4. Returns JSON with server name, status (Online/Offline), player count, description
5. Caches response for 60 seconds
---
## Environment Variables
Configure these in Cloudflare Workers dashboard:
| Variable | Description |
|----------|-------------|
| `PANEL_URL` | Pterodactyl panel URL (https://panel.firefrostgaming.com) |
| `CLIENT_API_KEY` | Pterodactyl client API key for webuser_api account |
---
## CORS Configuration
Allowed origins:
- `https://firefrostgaming.com`
- `https://firefrost-website.pages.dev`
---
## Response Format
```json
{
"servers": [
{
"id": "abc123",
"name": "All The Mods 10",
"status": "Online",
"players": 3,
"description": "ATM10 modpack server"
}
]
}
```
---
## Deployment
This Worker is deployed via Cloudflare dashboard. To update:
1. Edit code in Cloudflare Workers dashboard, OR
2. Use Wrangler CLI: `wrangler deploy`
**Note:** This file is the source of truth. If editing in dashboard, sync changes back here.
---
## History
| Date | Change | By |
|------|--------|-----|
| 2026-04-03 | Initial creation | Chronicler #56 (The Velocity) |
| 2026-04-08 | Added to git (was dashboard-only) | Chronicler #68 |
---
**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️