Junction TV API | Feed

The API returns a JSON object containing metadata for a particular item as determined by the value of ASSET_ID.

Resource URL

GET - /metax/2.1/details/{ASSET_ID}

Header Paramater

Authorization

required

Bearer Access Token

NOTE: Access Token here refers to the access authorization token.

URL Parameter

ASSET_ID

required

Asset ID is the unique ID of an asset.

Form Parameter

sub_id

optional

Subscriber ID (e.g. user@example.org) If subscriber ID is present, then the details object may contain personalized info like pauseTime, isFavorite etc.

device

optional

Type of the device. (e.g. roku, iphone, ipad, android-mobile, android-tab, web etc.) If this value is present, the MetaX will send the meta-data for that device only. (e.g. thumbnail)

Example Request URL

GET - http://__JTV_HOST__/metax/2.1/details/6149?device=__JTV__DEVICE__CODE__&subid=__SUBSCRIBER__ID__

Example Return

{
  id: "6149",
  title: "The Pom Pom Girls",
  type: "vod",
  thumbnail: "http://demo.junctiontv.com/assets/images/movies/the_pom_pom_girls_1976/small-cover.jpg",
  description: "A football player at Rosedale High School is amorous of one of the cheerleaders, who is going with another guy. Another player can't decide which of two cheerleaders he wants to be with. Meanwhile, the Big Game with Hardin High School is approaching, and a prank war is in full swing.",
  pub_year: "1976",
  duration: 89000,
  cuepoints: "0",
  avg_review: 5
}

{

id: "6149",

title: "The Pom Pom Girls",

type: "vod",

thumbnail: "http://demo.junctiontv.com/assets/images/movies/the_pom_pom_girls_1976/small-cover.jpg",

description: "A football player at Rosedale High School is amorous of one of the cheerleaders, who is going with another guy. Another player can't decide which of two cheerleaders he wants to be with. Meanwhile, the Big Game with Hardin High School is approaching, and a prank war is in full swing.",

pub_year: "1976",

duration: 89000,

cuepoints: "0",

avg_review: 5

}

The response of a invalid authorization access call ( Status #401) will look as follows:-

{
    result: "error",
    message: "UNAUTHORIZED",
    reason: "No Authorization Token"
}

{

result: "error",

message: "UNAUTHORIZED",

reason: "No Authorization Token"

}

To see how to get access token - (see Getting Access Tokens)

The response of an ERROR in authorization access call ( Status #404) will look as follows:-

HTTP Status 404

Feed – details