Welcome to IVA! Rovi and IVA have partnered to make integrating trailers into your site as easy as 1,2,3. This page will walk you through making a link to a video.
Step 1: Get your credentials
Please contact Michael Eitelman or your customer service representative at Rovi for your credentials. IVA does not have access to Rovi customers credentials. Make sure that you get the following:
- Customer ID ( this is your comany’s account number)
- Security Token ( do not share this with anyone outside your organization)
- Access to data feeds
Note: Please keep this information in a safe place as you will need it to access content at IVA.
Step 2: Get the data
Rovi and IVA have worked together to provide 2 feeds that will be updated once daily Monday – Friday and made available to Rovi customers. These feeds will include all the meta data you will need, including IVA’s Published ID and matching Rovi Program ID. The first feed is single XML file with all the data you need to do your matching and update your records. The second feed is broken up into two flat files. One file contains the data about the program and the other contains the available encodes for the video. Both feeds contain the same data so you only have to get one or the other. Please contact Rovi for access to these feeds and read through the Rovi Feed Data Dictionary to understand all the fields contained in these feeds. Be sure to use the latest version of the feed (v4 or above).
Step 3: Make a link to the video
Now that you have ingested all the data you can build the links to the video. To do so you will need the following information:
- Customer number
- Secret token
- Videokbrate – chosen from the available encodes
- Published ID of the video
In the example below we will assume that you will be using the cmd=6 and fmt=4 parameters. For more information on those please see the full Video API documentation. This example shows how to properly join your secret token along with your URL to be hashed. Customers are required to do an MD5 hash of the Secret Token + URL as a security measure to prevent deep linking to the content. The e parameter is a time to live for the link and is the Unix time for when the link should expire. IVA recommends that you generate these links on the fly and keep the time to live as short as possible ( 10 – 30 min). It is important to note that you need to append the secret token to the front of the URL and lower case the whole string.
Secret Token = 1234 Pseudo-code to Generate Hash = MD5(lcase(1234http://video.internetvideoarchive.net/player.aspx?customerId=18088&cmd=6&fmt=4&videokbrate=750&publishedid=1757&e=1171159092)) Hash = c13c876ea56c6124cba712c050a7ae69
For more information, including a full description of all the parameters and creating the hash code please see this page: http://www.internetvideoarchive.com/documentation/video-api/
We look forward to working with you! Should you have any questions please feel free to email our Support Team. Thanks for choosing Rovi and IVA!