Get Published Rendition Using Filename
get
/content/published/api/v1.1/assets/{id}/{rendition}/{filename}
Get the rendition of a published digital asset using both the ID 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
-
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.
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
The following example shows how to get published Digital Asset rendition file with filename.
curl -i -X GET -H "Accept:application/json" 'http://<hostname>/content/published/api/v1.1/assets/{id}/{rendition}/{filename}'
Example
Obtains published Digital Asset Thumbnail rendition with id: CONT826832D8B7BC4BDBA372586ECFCB47DD, with channelToken:b361a487716547d8a7527021a2d6628c with filename: audi1_1594289317364.jpg
content/published/api/v1.1/assets/CONT826832D8B7BC4BDBA372586ECFCB47DD/Thumbnail/audi1_1594289317364.jpg?format=jpg&type=responsiveimage&channelToken=b361a487716547d8a7527021a2d6628c
Response Body
DigitalAsset Thumbnail rendition file will be displayed.