Asset & Telemetry API reference
The MediaEdge API delivers catalog objects, media segments, and delta synchronization streams across regional endpoints.
Delivery Endpoints (Authenticated)
| Endpoint | Method | Purpose |
|---|
/api/v1/chunks | GET | Primary chunked object stream |
/api/v1/assets | GET | Binary catalog asset blocks |
/api/v2/sync | GET | Manifest & state synchronization |
/edge/v1/pull | GET | Regional PoP pull channel |
/stream/v1/segments | GET | Low-latency media segment pipeline |
/cdn/v1/blocks | GET | Content-addressed block transfer |
Public Telemetry & Benchmark Endpoints
| Endpoint | Method | Purpose |
|---|
/api/v1/status | GET | Node operational status (JSON) |
/api/v1/health | GET | Lightweight health probe for uptime monitors |
/api/v1/nodes | GET | PoP cluster metrics & hit-ratio summary |
/api/v1/bench/ping | GET | Edge RTT measurement |
/api/v1/bench/up | GET | Session frame | POST | Chunked uplink throughput test | amp; edge round-trip verification
Request headers & parameters
| Name | Placement | Meaning |
|---|
s | Query | Stream session token (8–12 chars, Base62 alphanumeric) |
p | Query | Chunk page sequence number: ?p=0&s=..., ?p=1&s=... |
_dc / X-Cache | Query / Header | Dynamic cache-control & padding hint token |
X-Request-Id | Header | Per-request frame identifier |
Example
curl -s "https://node.example/api/v1/status"
curl -H "X-Request-Id: 01HWZ8..." -H "X-Cache: _dc=aB3fK9qL2mN7" \
"https://node.example/api/v1/chunks?p=0&s=k9Qm2xWp7A"