We are currently finalising the API's but the basic information is as follows:-

The API is implemented as XML over HTTP using all four verbs (GET / POST / PUT & DELETE). A unique URL for each function is provided and allows implemented in isolation - eg you could then use our video player or choose to use your own embedded player by simply passing the correct variables. We have followed the REST principles.

Generic Settings

All applications wishing to utilise our API's much have a public and private key in the following format.

API Account Public Key: siU83K3j3Saa2z2s8S3dD7a2pWd5Nj45
API Account Private Key: bdfhehHtafy78Sn8Snm9r9yw8tR3daOp

Video Playback

http://api.talentonview.co.uk/videoplayer.php?pid=xxxxxx&tid=12345678912345678912345678900&vid=X

pid = unique API account public key
tid= uninque 32bit video token in MD5 format generated from your own public and private keys.
vid= unique video id number
All 3 are required to successfully download the video for playback.

An example implementation in PHP would be:

require_once(dirname(__FILE__)."/ToVAuth.php");
$publicKey= "APPLICATION KEY";
$url = "http://api.talentonview.co.uk/s.php?pid=".$publicKey."&tid=".$tmAuth->getToken()."&vid=".$video;
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 30);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($ch);
curl_close ($ch);
echo $response;
?>

By the same token - uploading a video is just as straight forward.

Video Upload

http://api.talentonview.co.uk/videoupload.php?cid=xxxxxx&tid=12345678912345678912345678900&vid=X

HTTP Status Codes

Talent on View returns HTTP status codes for every request

200 OK - Everything fine
400 Bad Request - invalid request
403 Forbidden - we understand your request but are refusing it
404 Not Found - invalid url
503 Service Unavailable - please try again later