Delivery

When you search for assets, the actual images, videos, or other downloadable media are delivered by a different host than that used for the page. The media delivery service provides it through delivery links (also called renditions).

Pre-authenticated URLs

Content retrieved from a separate host must be secured. To secure content from another domain, you cannot use cookies.

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 requested URL has the following format:

RequestResponseshell
https://{host}/api/delivery/{apiVersion}/{tenantId}/{key}{?expires,entityid,userid,rendition,watermark,signature}
Important

You do not need to send requests directly to the media delivery service (MDS). The request URLs are built transparently when using Content Hub.

The following table lists the parameters of the requested URL.

Note

These parameters are automatically generated by the AssetExtensionDataMessageHandler.

NameDescriptionMandatory
apiVersionUsed for compatibility purposes in case of potential future breaking changes.Yes
tenantIdIdentifies the tenant that made the request.Yes
keyThe key identifies a binary large object (BLOB) in a file provider.Yes
signatureThis signature validates the URL.Yes
entityidParameter used for logging the download event.No
useridParameter used for logging the download event.No
renditionParameter used for logging the download event. If there is no rendition, the resource is returned inline, otherwise as an attachment and possibly using a redirection to the backend store.No
intentEither download or streaming, to indicate if the intention is to use the resource inline or as an attachment.No
watermarkA watermark that you can apply to the image.No
expiresDate and time (in ISO8601) that specifies when this URL is no longer valid. If not present, there is no expiration.No
filenameName of the file.No

Do you have some feedback for us?

If you have suggestions for improving this article,