Fingls Edge CDN Architecture & API

Fingls Edge CDN operates an autonomous Anycast network across tier-1 regional PoPs. Designed for sub-10ms delivery of game updates, binary assets, and streaming chunks.

Quickstart: Origin Header Configuration

Configure your upstream origin web server to emit standard RFC 7234 cache headers. The edge respects s-maxage, immutable, and stale-while-revalidate:

# Recommended Nginx Origin Header Block
location /assets/ {
    # Cache for 1 year at Edge, 1 day on client browser
    add_header Cache-Control "public, max-age=86400, s-maxage=31536000, immutable";
    add_header Vary "Accept-Encoding";
    add_header X-Origin-ID "msk-core-cluster";
}

Edge Response Headers

Every response served through the edge network includes real-time telemetry headers:

Header	Example	Description
`X-Fingls-PoP`	`RU-MSK-01`	Three-letter regional Anycast PoP serving the incoming connection.
`X-Cache`	`HIT \| MISS \| BYPASS`	Specifies whether the asset was served from local NVMe RAM cache or fetched from origin.
`X-Edge-Cache-Age`	`412.08s`	Time in seconds since the asset was last refreshed in the local node cache.
`Alt-Svc`	`h3=":443"; ma=86400`	Signals HTTP/3 QUIC connection capability to modern browsers and clients.

Health Probe API

GET /api/v1/health

Returns health status, active PoP identifier, cluster throughput, and SLA metric.

curl -s https://cdn.fingls-server.online/api/v1/health | jq .

{
  "status": "operational",
  "edge_node": "RU-MSK-01",
  "datacenter": "Contell-Moscow",
  "cluster_sla": "99.999%",
  "cache_hit_ratio": 0.986,
  "active_pops": 42
}

Live Edge Telemetry API

GET /api/v1/telemetry

Detailed real-time peering metrics, transit loss statistics, and backbone capacity.

curl -s https://cdn.fingls-server.online/api/v1/telemetry | jq .

{
  "network": "Fingls-Anycast-Global",
  "ingress_node": "ru-msk-01.edge.anycast",
  "peering": "MSK-IX / RETN Tier-1",
  "backbone_gbps": 4200,
  "avg_latency_ms": 3.4,
  "packet_loss_pct": 0.00,
  "bbr_congestion_active": true
}

Global PoP Discovery API

GET /api/v1/nodes

List of active core edge nodes with status, locations, and uplink capacity.

curl -s https://cdn.fingls-server.online/api/v1/nodes | jq .

[
  { "id": "ru-msk-01", "city": "Moscow", "country": "RU", "status": "active", "uplink": "100G" },
  { "id": "fi-hel-01", "city": "Helsinki", "country": "FI", "status": "active", "uplink": "40G" },
  { "id": "nl-ams-01", "city": "Amsterdam", "country": "NL", "status": "active", "uplink": "100G" },
  { "id": "de-fra-01", "city": "Frankfurt", "country": "DE", "status": "active", "uplink": "100G" }
]

Cache Purge API

POST /api/v1/purge

Instantly purges edge cache for a specific URL or wildcards across all 42 PoPs within 150ms.

curl -X POST https://cdn.fingls-server.online/api/v1/purge \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer fingls_sec_key_live_9921" \
     -d '{
       "urls": [
         "https://cdn.fingls-server.online/assets/app.v2.js",
         "https://cdn.fingls-server.online/assets/styles.css"
       ]
     }'