Delivery API Reference
Read-only endpoints for fetching media manifests and segment metadata. All responses are JSON unless stated otherwise.
Getting started
Base path is versioned. Clients should pin a major version and handle 410 Gone for retired ones.
GET /api/v4/media/manifest?id=<asset> Accept: application/json
Authentication
Public assets need no credentials. Private ones use a short-lived signature appended to the query string.
Segments
| Field | Type | Notes |
|---|---|---|
| duration | float | seconds, 3 decimals |
| bandwidth | int | bits per second |
| codecs | string | RFC 6381 form |
Error codes
| Code | Meaning |
|---|---|
| 400 | malformed query |
| 404 | asset not found |
| 429 | too many requests |
| 503 | upstream unavailable |
Rate limits
Default quota is 120 requests per minute per address. Exceeding it returns 429 with a Retry-After header.
Changelog
v4.3 — added codecs to segment payload.
v4.2 — manifest caching headers aligned with upstream.
v4.1 — deprecated legacy_id.