ASaspect
Assets

Get asset download URL

Get a temporary URL for one of the asset's files.

Every URL supports range requests. For original, each response's ETag is the asset's manifest_id: to resume a download without mixing two versions of the file, send that ETag back in If-Range.

get/assets/{asset_id}/download

Request

  • Base URL
    https://api.aspect.inc
  • URL
    https://api.aspect.inc/assets/{asset_id}/download
  • Auth
    API key in header Authorization

Path parameters

asset_idstring uuid required

The ID of the asset to download

Query parameters

variant'original' | 'stream_proxy' | 'preview'

A file a user can download: the uploaded original, the web-playable stream proxy, or the preview image.

File to download: original (the uploaded file), stream_proxy (the web-playable copy), or preview (the thumbnail image).

prefer_custom_thumbnailboolean

For preview, return the custom thumbnail when one is set instead of the generated preview.

Response

Successful Response

urlstring required

Temporary URL for the upload or download

url_expires_atstring date-time required

UTC datetime when the URL expires

Changes

No recorded changes to this operation across all 1 revision of this API.