Ingest VODs using the Management API

The Management API allows for programmatic ingest of metadata, materials and publications among other things. The simplest VOD-ingest case with just a minimum of metadata and a material is described below.

Prerequisites

Video file availability

The video file that is to be ingested has to be available to the RedBee MOTT backend. This can be achived in multiple ways. The most common ones are

• The file is publically available over HTTP(S)
• The file is available over HTTP(S) using some sort of SAS-URI
• The file is available over HTTPS and protected by basic access authentication
• The file is in a AWS S3 bucket and a user with the correct permissions is shared with RedBee
• The files are uploaded to a RedBee managed Azure blob storage or AWS S3 bucket ¹

Credentials

To request credentials for use with the management API please contact RedBee.

API Endpoints

API documentation: https://mgmtapidocs.emp.ebsd.ericsson.net/

The parts of the management API that are relevant for a simple VOD ingest is the ingest part of the API and in particular the endpoint /v1/customer/{customer}/businessunit/{businessUnit}/asset.

To create a asset with minimum metadata and a material simply POST the following XML

<?xml version="1.0" encoding="UTF-8"?>
<publish-metadata xmlns="http://video-metadata.emp.ebsd.ericsson.net/publish-metadata/v1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://video-metadata.emp.ebsd.ericsson.net/publish-metadata/v1 publish-metadata-1.0.xsd">
    <data>
        <asset>
            <id>assetID</id>
            <titleList>
                <title language="en">Asset title</title>
            </titleList>
            <assetType>movie</assetType>
        </asset>
        <material>
            <materialRef><![CDATA[https://example.com/movie.mp4]]></materialRef>
            <DRMEnabled>false</DRMEnabled>
        </material>
    </data>
</publish-metadata>

Element	Summary
//asset	Wrapper for all metadata like titles, posters, actors, etc.
//asset/id	A string identifyng the asset in your system
//asset/titleList	Wrapper for titles in different languages
//asset/titleList/title	A title in a specific language indicated by the "language" attribute
//asset/assetType	Indicates that this is a movie and not a trailer or ad
//material	Wrapper for all technical metadata for the material ingest like source file, drm, ad markers, etc.
//material/materialRef	The location of the source file. Usually a URL or relative path.
//material/DRMEnabled	Should DRM be enabled or not

For more extensive documentation on the XML format see the XSD: https://github.com/EricssonBroadcastServices/EMP-api/blob/master/asset-ingest/publish-xml/src/main/xsd/publish-metadata.xsd

---

1. Requires separate agreement with RedBee ↩