Skip to end of banner
Go to start of banner

Direct Downloads

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

Introduction

From version 22.4 it will possible to request a direct URL to the original or preview representation of any item.

Contract

A new endpoint without authentication is available as

https://<public host>/representations/<Record Id>?type=<type>

Example

https://mh-tst.mediahaven.com/representations/ee453c142a22402a8e913c33cde74e9e7ed868dfce2d499fa24bb54830933aee?type=Access

Parameters

  • Record ID is the unique identifier of an item as documented in Metadata 22.3

  • Type: value is either Original (default) or Access

Response

When sending a GET request with optional parameters, the gateway service responds with a temporary redirect 302 Found to the appropriate storage URL. We use a temporary redirect because we want the browser to keep using the representation endpoint in order to count future statistics. When the parameter type is not provided, it is assumed to be Original.

Statistics

To store the events, we log them as Premis Events on the (flat) data object with types

  1. DIRECT_DOWNLOAD.ORIGINAL

  2. DIRECT_DOWNLOAD.ACCESS

Configuration

  • By default, the original is not accessible directly by any means and the response for type=Original will be 403 Forbidden

  • Upon a service request, the original storage can be publicly available with the caveat that the knowledge of the RecordId is sufficient to download any original

  • No labels