3CDN Public API Documentation

Version: v1

> base_url............. https://api.3cdn.online/api/v1

> protocol............ JSON / REST

> auth................ API-Key (header)

> rate_limit.......... 120 req/min

Endpoints

GET /status

Returns basic API availability.

curl -X GET https://api.3cdn.online/api/v1/status

{
  "status": "ok",
  "timestamp": "2026-04-11T09:57:00Z"
}

GET /ip

Returns your detected client IP.

{
  "ip": "203.0.113.42"
}

GET /edge

Returns the edge node that processed your request.

{
  "edge": "ams-1.edge.3cdn.online"
}

GET /geo

Returns geolocation info for the client IP.

{
  "country": "NL",
  "city": "Amsterdam",
  "asn": 12345
}

POST /purge/url

Purges a single URL from cache. Requires API-Key.

curl -X POST https://api.3cdn.online/api/v1/purge/url \
  -H "X-API-Key: YOUR_KEY" \
  -d '{"url": "https://site.com/image.png"}'

POST /purge/host

Purges all cached content for a host. Requires API-Key.

curl -X POST https://api.3cdn.online/api/v1/purge/host \
  -H "X-API-Key: YOUR_KEY" \
  -d '{"host": "site.com"}'

GET /metrics/cache

Returns cache hit/miss statistics. Requires API-Key.

{
  "hit": 82341,
  "miss": 12988,
  "ratio": 0.86
}

GET /metrics/latency

Returns average latency by region. Requires API-Key.

{
  "eu": 12,
  "us": 84,
  "asia": 142
}

GET /config

Returns current CDN configuration. Requires API-Key.

{
  "cache_ttl": 3600,
  "edge_nodes": ["ams-1", "fra-2", "nyc-1"]
}