Delivery links
When you search for assets, the actual images, videos, or other downloadable media are delivered by a host that is different from the one used for the page. The media delivery service (MDS) provides them through delivery links (also called renditions).
Pre-authenticated URLs
To secure content from another domain, you cannot use cookies. By using pre-authenticated URLs, the delivery host can authorize the client to retrieve the resource without contacting the Content Hub portal.
Audit logging
The delivery host can post a Download event message on a queue to aggregate all the download events outside the portal host and perform analysis or auditing. The delivery host can add a per-request watermark.
In addition to a dedicated satellite node, the portal also acts as a satellite node.
Request URL
The request URL has the following format:
https://<HOST>/api/delivery/<API_VERSION>/<TENANT_ID>/<KEY>{?expires,entityid,userid,rendition,watermark,signature}
You do not need to send requests directly to the MDS. The request URLs are built transparently when using Content Hub.
The following table lists the parameters of the request URL.
|
Parameter |
Description |
Mandatory |
|---|---|---|
|
|
The API version. It is used for compatibility purposes in case of potential future breaking changes. |
Yes |
|
|
The ID that Identifies the tenant that made the request. |
Yes |
|
|
The key that identifies the binary large object (BLOB) in a file provider. |
Yes |
|
|
The signature that validates the URL. |
Yes |
|
|
Used for logging the download event. |
No |
|
|
Used for logging the download event. |
No |
|
|
Used for logging the download event. If there is no rendition, the resource is returned inline, otherwise it is returned as an attachment, and possibly using a redirection to the back-end store. |
No |
|
|
The purpose of the link - either download or streaming- to indicate if the intention is to use the resource inline or as an attachment. |
No |
|
|
A watermark that you can apply to the image. |
No |
|
|
Date and time (in ISO8601) when the link expires and the URL is no longer valid. If not present, there is no expiration. |
No |
|
|
Name of the file. |
No |
These parameters are automatically generated by the AssetExtensionDataMessageHandler implementation.