Constructing the download/stream urls URLs can be done manually using two different approaches:
- HttpHandler
- Aspx
Both methods ends end up running the same code and hence are equally good. There are some theoretical advantages of using the HttpHandler as that one is earlier in the .net pipeline and therefore utilizes the IIS better. The disadvantages disadvantage to this is that the extension of what is requested needs to be known beforehand and as such, this is not always doable.
...
As the download and stream is are implemented as a httphandlerHttpHandler, it is a bit different than the other endpoints. The url URL can be constructed in the following way
...
the explanation of the ids are as follows
| Name | Description |
|---|---|
| assetid | this This is the id of the asset in Digizuite |
| mediaformatid | the The format in which the asset is transcoded is defined in Digizuite. This id corresponds to such a format |
| destinationid | this This implies where the file should be downloaded from. These IDs are accessible in Digizuite under System tools/Destinations |
| assetype | determines Determines the type of the asset. Use GetAssetTypes to get a list of all available asset types |
| outputident | Enum that determines how the file should be output. 11 is default preview (used for stream) and 44 is download |
| filmstripid | There Is there for backwards backward compatibility - i.e. it's not used anymore. Set this to 0. |
| accessKey | The accessKey that grants access to the api |
| Download boolean | True = file downloaded and False = file is returned as a stream |
| Extension of mediaformat | This should be set to whatever the mediaformat is setup to create (i.e. jpg, if the output of the format is a jpg file) |
Using aspx
The apsx url URL can be constructred constructed in the following manner:
http(s)://damurl.com/dmm3bwsv3/assetstream.aspx?assetid={assetid}&mediaformatid={mediaformatid}&destinationid={destinationid}&accessKey={accessKey}
the explanation of the ids are as follows
| Name | Description |
|---|---|
| assetid | this This is the id of the asset in Digizuite |
| mediaformatid | the The format in which the asset is transcoded is defined in Digizuite. This id corresponds to such a format |
| destinationid | this This implies where the file should be downloaded from. These IDs are accessible in Digizuite under System tools/Destinations |
| accessKey | The accessKey that grants access to the apiAPI |