MetadataBasicCreate()

Create a new BasicAsset for a given ContentID.

A BasicAsset with status urn:dece:type:status:deleted or urn:dece:type:status:active with this ContentID MUST NOT yet exist.

API URL:

[BaseURL]/Asset/Metadata/Basic

Request Method:

POST

Request Format

XML type:

dece:BasicAsset

Required information:

BasicAsset
- BasicData
- @ContentID
  - LocalizedInfo
    - @Language
    - TitleDisplay19
    - TitleDisplay60
    - TitleSort
    - ArtReference
      - @Resolution
    - Summary190
    - Summary400
    - OriginalTitle
    - CopyrightLine
  - RunLength
  - ReleaseYear
  - WorkType

Optional information:

BasicAsset
- BasicData
  - UpdateNum
  - ReleaseDate
  - ReleaseHistory
  - WorkTypeDetail
  - PictureColorType
  - PictureFormat
  - ThreeD
  - AspectRatio
  - AltIdentifier
  - RatingSet
  - People
  - CountryOfOrigin
  - PrimarySpokenLanguage
  - OriginalLanguage
  - VersionLanguage
  - AssociatedOrg
  - SequenceInfo
  - Parent

Response Format

Status Code:

HTTP 202

Headers:

Location: [BaseURL]/Asset/Metadata/Basic/{ContentID}?UpdateNum=1

Errors

ParserException
- Missing /BasicAsset element
- HTTP Status Code: 400
UpdateNumIsInvalid
- /BasicAsset/BasicData/UpdateNum was invalid
- HTTP Status Code: 400
MandatoryFieldCannotBeNullOrEmpty
- Either of the required fields is missing
- HTTP Status Code: 400
MdBasicMetadataAlreadyExist
- The basic metadata already exists.
- HTTP Status Code: 409

Example

Create a new BasicAsset to be consumed in the UV ecosystem

The following example creates a new BasicAsset

Sample Request:

POST /rest/2015/02/Asset/Metadata/Basic HTTP/1.1
Host: api.uvvu.com
Accept: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<BasicAsset xmlns="http://www.decellc.org/schema/2015/03/coordinator" xmlns:ns2="http://www.movielabs.com/schema/md/v2.3/md">
  <BasicData ContentID="urn:dece:cid:org:customer-zero:123456789">
    <ns2:LocalizedInfo language="en-US">
      <ns2:TitleDisplay19>cvp_TitleDisplay19</ns2:TitleDisplay19>
      <ns2:TitleDisplay60>TitleDisplay60</ns2:TitleDisplay60>
      <ns2:TitleSort>cvp_this is title sort for asset</ns2:TitleSort>
      <ns2:ArtReference resolution="800x1200">https://cdn.com/test_800_1200.png</ns2:ArtReference>
      <ns2:ArtReference resolution="840x1200">https://cdn.com/test_840_1200.png</ns2:ArtReference>
      <ns2:ArtReference resolution="192x288">https://cdn.com/test_192_288.jpg</ns2:ArtReference>
      <ns2:ArtReference resolution="224x320">https://cdn.com/test_224_320.jpg</ns2:ArtReference>
      <ns2:ArtReference resolution="112x160">https://cdn.com/test_112_160.jpg</ns2:ArtReference>
      <ns2:Summary190>cvp_this is summary190</ns2:Summary190>
      <ns2:Summary400>cvp_this is summary400</ns2:Summary400>
      <ns2:OriginalTitle>cvp original title</ns2:OriginalTitle>
      <ns2:CopyrightLine>cvp_this is copyright</ns2:CopyrightLine>
    </ns2:LocalizedInfo>
    <ns2:RunLength>P0Y0M0DT1H30M</ns2:RunLength>
    <ns2:ReleaseYear>2011</ns2:ReleaseYear>
    <ns2:WorkType>Short</ns2:WorkType>
  </BasicData>
</BasicAsset>

Sample Response:

HTTP/1.1 202
Date: [Date]
Content-Type: text/plain
Location: [BaseURL]/Asset/Metadata/Basic/urn:dece:cid:org:customer-zero:123456789?UpdateNum=1
X-transaction-info: [TransactionInfo]

MdBasic Create Request has been accepted for processing, but the processing has not been completed