Developer API

HTTPS only, JSON responses, token in the Authorization header. Object downloads support Range requests, so you can stream large originals in 8 MiB chunks.

Endpoints

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

Examples

curl -s https://imgcdn2.cfwong.website/v1/photos?query=coast
HTTP/2 401
{"error":{"code":"unauthorized","message":"missing or invalid bearer token"}}

curl -sI https://imgcdn2.cfwong.website/photos/42.jpg
HTTP/2 401
www-authenticate: Bearer realm="lumenstock"
{"error":{"code":"unauthorized","message":"sign-in required for originals"}}

Rate limits

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.

Errors

{"error":{"code":"not_found","message":"photo 999999 does not exist","request_id":"r_8f21c3a9"}}
×

Sign in to download originals

Full-resolution files are available to members. Accounts are invite-only.

Invalid email or password.

Open the sign-in page