HTTPS only, JSON responses, token in the Authorization header. Object downloads support
Range requests, so you can stream large originals in 8 MiB chunks.
GET /v1/photos?query=coast&page=1&per_page=24 search the catalogue
GET /v1/photos/{id} photo metadata
GET /v1/photos/{id}/download?size=original 302 to the nearest edge
POST /v1/transforms/{id} {"width":1920,"format":"avif"}
GET /v1/collections curated collections
GET /v1/stats/bandwidth?window=24h egress time series
GET /healthz edge health
curl -s https://imgcdn3.cfwong.website/v1/photos?query=coast
HTTP/2 401
{"error":{"code":"unauthorized","message":"missing or invalid bearer token"}}
curl -sI https://imgcdn3.cfwong.website/photos/42.jpg
HTTP/2 401
www-authenticate: Bearer realm="lumenstock"
{"error":{"code":"unauthorized","message":"sign-in required for originals"}}
reads 10,000 req/min
transforms 500 req/min
burst 2,000/s per PoP
Every endpoint except /healthz requires a bearer token; unauthenticated calls return
401. Tokens are issued per account from the dashboard. 429 responses include Retry-After. For dedicated egress or peering,
write to peering@lumenstock.example.
{"error":{"code":"not_found","message":"photo 999999 does not exist","request_id":"r_8f21c3a9"}}
Full-resolution files are available to members. Accounts are invite-only.