LogicalAssetCreate()

Create a new LogicalAsset to provide a mapping from a MediaProfile to a ContentID.

This mapping directly affects the validity of a RightsToken created via RightsTokenCreate(); mappings limit the PurchaseProfiles of a RightsToken to those available in the Coordinator ecosystem.

API URL:

[BaseURL]/Asset/Map

Request Method:

POST

Request Format

XML type:

dece:LogicalAsset

Required information:

LogicalAsset
- @ALID
- @ContentID
- @MediaProfile
- @AssentStreamAllowed
  - AssetFulfillmentGroup
    - DigitalAssetGroup

Response Format

Status Code:

HTTP 201

Headers:

Location: [BaseURL]/Asset/Map/{MediaProfile}/{ALID}

Errors

AssetLogicalIDNotValid
- Provided ALID is not valid
- HTTP Status Code: 400
AssetProfileInvalid
- Provided MediaProfile is not valid
- HTTP Status Code: 400
LogicalAssetAlreadyExist
- The mapping already exists; The mapping was deleted and cannot be re-created
- HTTP Status Code: 409
CreateOrUpdateSeriesOrSeasonLogicalAssetForbidden
- Cannot create a LogicalAsset for a Series or Season BasicAsset type
- HTTP Status Code: 403

Example

Create a new LogicalAsset to be consumed in the UV ecosystem

The following example creates a new LogicalAsset for a known ContentID

Sample Request:

POST [BaseURL]/Asset/Map HTTP/1.1
Content-type: application/xml; charset=UTF-8
Host: api.uvvu.com

<?xml version="1.0" encoding="UTF-8"?>
<LogicalAsset xmlns="http://www.decellc.org/schema/2015/03/coordinator" xmlns:ns2="http://www.movielabs.com/schema/md/v2.3/md" xmlns:ns3="http://www.w3.org/2000/09/xmldsig#" xmlns:ns4="http://www.w3.org/2001/04/xmlenc#" ALID="urn:dece:alid:org:customer-zero:123456789" MediaProfile="urn:dece:type:mediaprofile:sd" ContentID="urn:dece:cid:org:customer-zero:123456789" AssentStreamAllowed="true">
  <AssetFulfillmentGroup>
    <DigitalAssetGroup>
    </DigitalAssetGroup>
  </AssetFulfillmentGroup>
</LogicalAsset>

Sample Response:

HTTP/1.1 201
Date: [Date]
Content-Type: text/plain
Location: [BaseURL]/Asset/Map/urn:dece:type:mediaprofile:sd/urn:dece:alid:org:customer-zero:123456789
X-transaction-info: [TransactionInfo]

Logical Asset Created Successfully