Preview a specific rendition of the digital asset by slug using filename
get
/content/preview/api/v1.1/assets/.by.slug/{slug}/{rendition}/{filename}
Get the rendition of latest version of a digital asset using both the slug and filename. The content-type header received in the response has the media type information.
Request Headers (Optional):
Request Headers (Optional):
Header Name | Header Value |
---|---|
channelToken | {valid channel token value} |
Request
Path Parameters
-
filename: string
Name of the Digital item, special characters in name must be encoded
-
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.
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.
Examples
Example:
The following example shows how to preview the Digital Asset rendition file with filename by it's slug by submission of a GET request on the REST resource using cURL:
curl -X GET -H 'Accept: application/json' 'https://host:port/content/preview/api/v1.1/assets/.by.slug/image-1489851752573-sport/Thumbnail/sport.jpg?format=jpg&type=responsiveimage&channelToken=b361a487716547d8a7527021a2d6628c'
Obtains latest version of the DigitalAsset Thumbnail rendition with slug: image-1489851752573-sport, with channelToken:b361a487716547d8a7527021a2d6628c with filename: sport.jpg.
Response Body
Digital Asset native file will be displayed.