Get Rendition of a Digital Item
get
/content/management/api/v1.1/assets/{id}/{rendition}
Get a specific rendition of the digital item. Content-type header in the response is set to the correct value for the file type.
Request
Path Parameters
-
id: string
id of the item.
-
rendition: string
Rendition name of the digital item.
Query Parameters
-
asOf(optional): string
This parameter describes a specific item revision. Currently it only supports this value, latestPublished, which means the latest published version.
-
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
Format of the digital item's rendition file. When the rendition has only one format, the format query parameter may be omitted.
-
type(optional): string
Rendition type of the digital item.
Response
Supported Media Types
- application/octet-stream
- application/json
200 Response
OK.
304 Response
Not modified.
400 Response
Bad request.
403 Response
Forbidden.
404 Response
Not found.
500 Response
Internal server error.
Examples
Example:
The following example shows how to render a digital item (using a digital item ID and rendition type) by submission of a GET request on the REST resource using cURL:
Note:
All the digital item IDs starts with CONT.
curl -X GET -H 'Accept: application/json' 'https://host:port/content/management/api/v1.1/assets/{id}/{rendition}'
Example:
Response Body
Digital Item is Displayed.