Junction TV API | Ingestion

This API will work in Asynchronous manner . It will immediately return “Success” if items are ingested properly. It may take some time to sync with our MetaX system based on the quantum items in the feed to be ingested.

Resource URL

GET - /metax/3.0/ingest/pull/

Header Paramater

Authorization

required

Bearer Access Token to be sent with all client requests.

Form Parameter

feed

required

Public URL of the feed to be ingested.

Example Request URL

GET - http://__JTV__HOST__/metax/3.0/ingest/pull/

Example Request

Example PHP Code

/**
 * Ingestion – Pull Metadata
 *
**/
// Example Feed URL
$feed_url = 'http://_FEED_URL_';


// Initialize pull data
$ch = curl_init("http://__JTV__HOST__/metax/3.0/ingest/pull/?feed=" . rawurlencode($feed_url) ); 
curl_setopt_array($ch, array(
	CURLOPT_CUSTOMREQUEST  => "GET",
	CURLOPT_RETURNTRANSFER => TRUE,
	CURLOPT_HTTPHEADER     => array(
		"Authorization: Bearer " . $token // Get token from "Getting Access Tokens"
	)
));

//execute
$result = curl_exec($ch);

// Check for errors
if (!curl_errno($ch)) {
  $httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
}else{
	die(curl_error($ch));
}

//close connection
curl_close($ch);

if(isset($httpcode) && $httpcode == 200){
	echo $result;
}else{
	echo "HTTP Status Code ". $httpcode;
}

/**

* Ingestion – Pull Metadata

**/

// Example Feed URL

$feed_url = 'http://_FEED_URL_';

// Initialize pull data

$ch = curl_init("http://__JTV__HOST__/metax/3.0/ingest/pull/?feed=" . rawurlencode($feed_url) );

curl_setopt_array($ch, array(

CURLOPT_CUSTOMREQUEST => "GET",

CURLOPT_RETURNTRANSFER => TRUE,

CURLOPT_HTTPHEADER => array(

"Authorization: Bearer " . $token // Get token from "Getting Access Tokens"

)

));

//execute

$result = curl_exec($ch);

// Check for errors

if (!curl_errno($ch)) {

$httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

}else{

die(curl_error($ch));

}

//close connection

curl_close($ch);

if(isset($httpcode) && $httpcode == 200){

echo $result;

}else{

echo "HTTP Status Code ". $httpcode;

}

Example Return

Success
HTTP status code : 200

{
    result : "success", 
    message: "Started processing"
}

{

result : "success",

message: "Started processing"

}

Faliure
HTTP status code : 401

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

{

result: "error",

message: "UNAUTHORIZED",

reason: "No Authorization Token"

}

HTTP status code : 404

{
    result: "error",
    message: "INVALID",
    reason: "Missing mandatory parameters.”
}

{

result: "error",

message: "INVALID",

reason: "Missing mandatory parameters.”

}

Ingestion – Pull