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.

Note

In addition to a dedicated satellite node, the portal also acts as a satellite node.

Request URL

The request URL has the following format:

RequestResponse

https://<HOST>/api/delivery/<API_VERSION>/<TENANT_ID>/<KEY>{?expires,entityid,userid,rendition,watermark,signature}

Important

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

apiVersion

The API version. It is used for compatibility purposes in case of potential future breaking changes.

Yes

tenantId

The ID that Identifies the tenant that made the request.

Yes

key

The key that identifies the binary large object (BLOB) in a file provider.

Yes

signature

The signature that validates the URL.

Yes

entityid

Used for logging the download event.

No

userid

Used for logging the download event.

No

rendition

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

intent

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

watermark

A watermark that you can apply to the image.

No

expires

Date and time (in ISO8601) when the link expires and the URL is no longer valid. If not present, there is no expiration.

No

filename

Name of the file.

No

Note

These parameters are automatically generated by the AssetExtensionDataMessageHandler implementation.

Do you have some feedback for us?

If you have suggestions for improving this article,