DC 5.9 Asset previewing and streaming
- Rasmus Hjelmberg Duemose Hansen
The asset streamer allows you to request files from assets. You must already have a valid access key to do this. However, some assets/formats can be published to NoSecurity destinations, which can be requested without authorization.
Suppose you are using asset APIs to get information about assets all these URLs will already be prebuilt for you. The prebuilt URLs encode a special signature so you can request them without passing additional authorization and without exposing the underlying access key if you use the URLs directly on a public webpage.
The asset URLs can be constructed manually, however, as Digizuite can change API’s between versions, then it is generally recommended to fetch these through the asset API’s described in the Getting assets sections
There are 2 Apis available:
Getting the asset source file
GET https://<my-dam>/digizuitecore/legacyservice/api/assetstream/{assetId}
Authorization: AccessKey <my-access-key>Getting a specific format from an asset
GET https://<my-dam>/digizuitecore/legacyservice/api/assetstream/{assetId}/{mediaFormatId}
Authorization: AccessKey <my-access-key>
It is also possible to pass an extension to the URL in case you are working with a system that requires it. The extension passed is completely ignored by the API, so it doesn’t necessarily have to match the media format. Therefore, it is generally recommended not to pass the extension.
GET https://<my-dam>/digizuitecore/legacyservice/api/assetstream/{assetId}.{extension}
Authorization: AccessKey <my-access-key>