# 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** 💙🔥❄️