Pour s’authentifier il est nécessaire d’avoir ces identifiants :
require\once(./DigitekaVideoUpload.php);
//Paramètres
$applicationId = 'votre_identifiant'; //fournie par Digiteka
$password = 'votre_mot_de_passe'; //fournie par Digiteka
$secretKey = 'votre_cle_secrete'; //fournie par Digiteka
$uploadvideo=newdigiteka_Video_Upload();
$uploadvideo->authenticate($applicationId, $password, $secretKey)Cliquez sur ici pour avoir le fichier PHP
Note : Authentification n’est valable que 24 heures et que pour l’envoie d’une vidéo.
Pour télécharger une vidéo il est nécessaire d’avoir :
Exemple de téléchargement d’une vidéo
<?php
//changement de l'emplacement temporaire par défaut dans /tmp
$uploadvideo->setTmpDir("/emplacement/de/mon/choix")
$resultSendFile=$uploadvideo->sendFile('/emplacement/videos/video.mp4')
?>Pour soumettre les métadonnées il est nécessaire d’avoir :
Métas facultatives :
Et d’utiliser la classe fonction sendMetas().
Exemple de soumission des métadonnées
<?php
$metas=array(
"title"=>"mon titre",
"description" => "ma description",
"picture"=>"/emplacement/image.jpg",
"category"=>"news",
"catalog"=>"5qlku0",
"publish_dm"=>false,
"langage"=>"fr",
"tags"=> array("politique","hollande","ps")
);
$resultSendMeta=$uploadvideo->sendMetas($metas);
?>La fonction sendMetas() renvoie une réponse au format JSON indiquant l’état final de la soumission des métadonnées.
Pour accéder aux donnés propre à l’intégration de la vidéo, il est nécessaire de publier celle-ci, après avoir :
Paramètres nécessaires :
Et d’utiliser la fonction publish().
<?php
$resultPublishVideo=$uploadvideo->publish('01757410','2');
?>La fonction publish() renvoie une réponse au format JSON indiquant l’iframe nécessaire à l’intégration de la vidéo.
<?php
require_once('library/Digiteka/Video/Upload.php');
$upload = new_Digiteka_Video_Upload();
$upload->setTmpDir('/home/');
$upload->authenticate('applicationId','password','secretkey');
$upload->sendMetas(array(
'title'=>'title',
'description =>'description',
'catalog'=>'3pf8p,
'category'=>'news',
'picture'=>'/home/test.jpg',
'langage'=>'fr',
'tags'=>array('tag1','tag2'),
'publish_yt=>true,
'publish_dm'=>false,
));
$upload->sndFile('test.mp4');
$upload->publish('01757410','2');
?>L’API de modification vidéo Digiteka vous permet de mettre à jour les métadonnées, vignettes ou même les fichiers vidéo de l’ensemble des vidéos de votre catalogue.
Cette documentation détaille les différentes options qui vous sont proposées ainsi que leur utilisation et leur mode de fonctionnement.
Si vous souhaitez mettre à jour uniquement les métadonnées vidéo, vous devez appeler la méthode sendMetas().
$applicationId="identifiant fourni par Digiteka";
$password="password fourni par Digiteka";
$secretKey="clé secrète fournie par Digiteka";
$uploadvideo = new Digiteka_Video_Upload();
$uploadvideo->setTmpDir("./tmp");
$token = $uploadvideo->authenticate($applicationId, $password, $secretKey);
$metas = array(
"video_id"=>"fu8fqp",
"title" => "Titre de la vidéo",
"description" => "Description de la vidéo",
"catalog" => "s038r",
"picture" => "/emplacement/image.jpg",
"category" => "news",
"sub_category" => array("liste des catégories envoyé par l’API qui correspond à news"),
"tags" => array("politique","hollande"),
"authors" => array("liste des auteurs"),
"ad" => "yes",
"status"=>"active"
);
$uploadvideo->sendMetas($metas);Attention :
“video_id” est obligatoire pour chaque appel à l’API. Vous n’êtes pas obligé de mettre à jour chaque variable, vous pouvez passer uniquement les champs qui ont besoin d’une modification.
Par exemple, vous pouvez modifier uniquement le titre de la vidéo en passant l’id de la vidéo comme suit.
Exemple :
$metas = array(
"video_id"=>"fu8fqp",
"title" => "Titre de la vidéo"
);
$uploadvideo->sendMetas($metas);En revanche, pour mettre à jour le fichier vidéo, vous devez appeler les trois méthodes sendMetas(), sendFile() et publish()
Exemple :
$applicationId="identifiant fourni par Digiteka";
$password="password fourni par Digiteka";
$secretKey="clé secrète fournie par Digiteka";
$uploadvideo = new Digiteka_Video_Upload();
$uploadvideo->setTmpDir("/emplacement/de/mon/choix");
$token = $uploadvideo->authenticate($applicationId, $password, $secretKey);
//passer uniquement l’id de la vidéo s’il n'y a pas d’autre métadonnée à changer.
$metas = array(
"video_id"=>"fu8fqp",
);
$uploadvideo->sendMetas($metas);
$uploadvideo->sendFile(“test.mp4”);
$uploadvideo->publish(“identifiant du site”, “zone de la site”);Valeurs acceptables
ad ( string ) :
status ( string ) :
Cette API vous fournit la liste des catalogues rattachés à votre société et également une liste des thématiques et sous-thématiques disponibles.
Exemple :
$applicationId="identifiant fourni par Digiteka";
$password="password fourni par Digiteka";
$secretKey="clé secrète fournie par Digiteka";
$uploadvideo = new Digiteka_Video_Upload();
$result = $uploadvideo->getcatalogtopic($applicationId, $password, $secretKey);Attention :
Les identifiants sont différents de ceux utilisés pour l’API de mise à jour des vidéos.