Jump to

• Request
• Response
• Examples

Preview a specific rendition of the digital asset by slug using Vanity URL

get

/content/preview/assets/{slug}/{rendition}

Renders a specific rendition of latest version of a digital asset. The content-type header received in the response has the media type information.

Request Headers (Optional):

Header Name	Header Value
channelToken	{valid channel token value}

Request

Path Parameters

• rendition: string
  Rendition name of the Digital Asset.
• slug: string
  Slug value of the item to be previewed.

Query Parameters

• channelToken(optional): string
  Channel token of the targeted channel. A channel token must be provided as either a query parameter or a request header.
• download(optional): boolean
  By default, media types such as image, audio, and video are set to inline for the content-disposition header. For all other media types, content-disposition is set to download. Users can specify the query parameter download as true/false in a request to override the default value.
• format(optional): string
  Media type extension of the Digital Asset file. When the rendition has only one format, the format query parameter can be omitted.
• type(optional): string
  Rendition type of the Digital Asset.

Back to Top

Response

Supported Media Types

• application/octet-stream
• application/json

200 Response

Successful operation.

304 Response

Not changed. The request honors requests with e-tag.

400 Response

Bad Request. The server is unable to process the request on the client side due to malformed syntax, invalid data or message framing.

403 Response

Forbidden. Client is not authorized to perform this request.

404 Response

The requested resource was not found.

500 Response

Internal server error. An unexpected error condition encountered in the system.

Back to Top

Examples

Example:

The following example shows how to preview the Digital Asset rendition file by Vanity URL by submission of a GET request on the REST resource using cURL:

curl -X GET -H 'Accept: application/json' 'https://host:port/content/preview/assets/image-1489851752573-sport/Thumbnail?format=jpg&type=responsiveimage&channelToken=b361a487716547d8a7527021a2d6628c' 

Obtains latest version of the DigitalAsset Thumbnail rendition with slug: image-1489851752573-sport, with channelToken:b361a487716547d8a7527021a2d6628c.

Response Body

Digital Asset Thumbnail renditions file will be displayed.

Back to Top