Next Call

The Next call requests continues an experience with a new set of recommendations based upon user interaction with the content. A next call should be made whenever the recommends need to be refreshed while maintaining the same experience value.

Scenarios for a Next Call:
1. User watches all assets in the initial Watch Call
2. User responds with either a like or dislike that alters the recommendation calculation

NOTE: When making a Next call after an Update call, make sure the Next call comes after receiving the IRIS API response from the Update call.

The necessary parameters for a Next call are:

platform_id: the reference ID from the publisher’s CMS
platform: the name of the publisher
number: the number of recommendations to be displayed in the response
access_token: created via OAuth 2 standard
user_id: ID associated to the individual user
client_token: string of characters to authorize the client
experience: Value that defines current stream of videos (generated on Watch call)

Sample Workflow

Client Incandenza requests a refresh in recommendations for user PGOAT

Documentation for creating access tokens

Call:

http://api.iris.tv/next?platform_id=46YDPA&platform=Incandenza&number=5&access_token=996JVD321AZ&user_id=PGOAT&client_token=99999&experience=53ebec0d321d0690858dw5r1

Response:

jQuery191028397097534104254_1407970311998({
  'success': true,
  'next': [
    {
      'iris_id': '51084789cd5f272312231105',
      'platform': 'Icandenza',
      'content_url': 'http://www.credenza.com/asset_6.mp4',
      'platform_id': '908JOL',
      'title': 'The Grapefruit Theif',
      'release_date': '2012-10-22 12:30:58 UTC',
      'reviewed': '2013-02-05 23:02:24 UTC',
    },
    {
      'iris_id': '539a5ba7f09c3f00172310bb',
      'platform': 'Icandenza',
      'content_url': 'http://www.credenza.com/asset_7.mp4',
      'platform_id': '874KFR'',
      'title': 'The Bird Baron Trailer',
      'release_date': '2014-06-12 20:51:53 UTC'
    },
    {
      'iris_id': '53cdc6233459980016231012',
      'platform': 'Icandenza',
      'content_url': 'http://www.credenza.com/asset_8.mp4',
      'platform_id': '891RGB',
      'title': 'Orson Welles UK Teaser Trailer',
      'release_date': '2014-07-20 19:51:07 UTC'
    },
    {
      'iris_id': '51084760cd5f2723122310a1',
      'platform': 'Icandenza',
      'content_url': 'http://www.credenza.com/asset_9.mp4',
      'platform_id': '908MAR',
      'title': 'Early Morning Moon Clip',
      'release_date': '2012-11-30 05:48:51 UTC',
      'reviewed': '2013-09-06 22:35:10 UTC',
    },
    {
      'iris_id': '53814f1af1585f0032231014',
      'platform': 'Icandenza',
      'content_url': 'http://www.credenza.com/asset_10.mp4',
      'platform_id': '56YLI',
      'title': 'C Grodin International Trailer',
      'release_date': '2014-05-24 19:33:28 UTC'
    }
  ],
  'experience': '53ebec0d321d0690858dw5r1'
})

Video Parameters In Next Response:

iris_id: IRIS.TV’s Reference ID for video
platform: the name of the publisher
content_URL: Link to video file on publisher’s CMS (only available if sent in during import process)
platform_id: the Reference ID from the publisher’s CMS
title: Title of video via publisher’s CMS
release_date: Date when asset could be recommended
reviewed: Date when asset was reviewed by IRIS.TV staff
experience: Value that defines the current stream of videos.

Errors

Invalid Access Token

Status Code: 401 Unauthorized
IRIS.TV Response: “The access token is no longer valid”
Problem: Access Token is invalid or has expired
Solution: Create a new access token using your Client Credentials

Documentation for creating access tokens

Invalid Client Token

Status Code: 401 Unauthorized
IRIS.TV Response: “IRIS API: Check your authentication credentials”
Problem: Client Token is Incorrect
Solution: Double check your client token. If still invalid, contact IRIS.TV support.

No Assets in Next Field

Problem: No assets in library.
Solution: Contact IRIS.TV representative and check import schedule.