Media Delivery API

Reference

Authentication

Every request carries a bearer token in the Authorization header. Tokens are issued per integration and can be revoked at any time. Requests without a valid token receive 401.

Endpoints

MethodPathDescription
GET/video/download/{asset_id}Stream the original file. Supports Range.
HEAD/video/download/{asset_id}Return size, checksum and content type without a body.
OPTIONS/video/download/List the methods allowed on the collection.

Response headers

HeaderMeaning
Content-LengthSize of the object in bytes.
ETagChecksum of the stored object.
Accept-RangesAlways bytes.
X-Cache-StatusEdge cache result: HIT, MISS or BYPASS.

Errors

StatusReason
401Missing or revoked token.
404Unknown asset identifier.
416Requested range is outside the object.
429Rate limit exceeded, retry after the interval in Retry-After.

Limits

Each token may keep up to 32 concurrent transfers. Objects are limited to 50 GB.