Jump to

• Request
• Response
• Examples

Get Published Rendition

get

/content/published/api/v1.1/assets/{id}/{rendition}

Renders a specific rendition of a published 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

• id: string
  Unique identifier (ID) of an item.
• rendition: string
  Rendition name of the Digital Asset.

Query Parameters

• channelToken(optional): string
  channelToken
• download(optional): boolean
  By default, for files of type image, audio and video are rendered inline. For all other file types are downloaded. User can specify the query parameter download=true/false in a request to override this default.
• 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.
• version(optional): string
  Version 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

The following example shows how to get published Digital Asset rendition file.

curl -i -X GET -H "Accept:application/json" 'http://<hostname>/content/published/api/v1.1/assets/{id}/{rendition}'

Example

Obtains published DigitalAsset Thumbnail rendition with id: CONT826832D8B7BC4BDBA372586ECFCB47DD, with channelToken: b361a487716547d8a7527021a2d6628c

/content/published/api/v1.1/assets/CONT826832D8B7BC4BDBA372586ECFCB47DD/Thumbnail?format=jpg&type=responsiveimage&channelToken=b361a487716547d8a7527021a2d6628c

Response Body

DigitalAsset Thumbnail renditions file will be displayed.

Back to Top