En complément à notre Nimbb Player, l'API contient également un Web Service. Le Web Service vous permet d’obtenir des fonctionnalités additionnelles sans passer par le Nimbb Player. Utiliser une fonction est aussi simple que d’appeler un URL et d’analyser les données retournées en format XML. La plupart du temps, vous utiliserez le Web Service à partir de code côté serveur.

Important : pour utiliser le Web Service, vous devez avoir un abonnement payant actif (Bronze ou supérieur).

À chaque appel de fonction, vous devez fournir votre clé publique de développeur ainsi que votre clé privée (excepté la fonction Account/Get et les fonctions Live). Ceci est essentiel pour authentifier votre requête. Sans ces informations, votre requête sera rejetée.

Toutes les fonctions du Web Service sont destinées à être utilisées avec le code côté serveur (sauf pour les fonctions Live). Si vous appelez les fonctions par du code HTML du client, vous exposez votre clé privée, qui est une violation de la sécurité de votre compte. Assurez-vous que vos visiteurs ne peuvent pas voir votre clé privée en regardant le code HTML de votre site.

Accès SSL : Toutes les fonctions peuvent être appelées en utilisant un URL sécurisé HTTPS comme "https://api.nimbb.com/". Pour utiliser le SSL, vous devez avoir un abonnement Platine ou supérieur.

Fonctions

Voici la liste des fonctions du Web Service que vous pouvez appeler.

Account/Get Obtenir des informations sur un compte.
Audit/Video Vérifier les informations vidéo de votre compte.
Video/Delete Supprimer une vidéo.
Video/Download Télécharger localement un fichier vidéo en formats FLV/MPG/MP4/MP3.
Video/Get Obtenir des informations sur une vidéo.
Video/List Obtenir la liste des vidéos actives liées à votre compte.
Video/Move Déplacer le fichier vidéo vers votre compte Amazon S3/Brightcove. (Abonnement Argent ou supérieur requis)
Video/Thumbnail Obtenir l'image vignette d'une vidéo en format JPEG pour l'enregistrer localement.

À noter :

  • Chaque appel de fonction peut retourner des codes d’erreur. Voir la page descriptive des Erreurs pour bien gérer celles-ci ;
  • Toutes les dates retournées par le Web Service sont en format UTC (Temps Universel Coordonné) ;
  • Optionnellement, vous pouvez spécifier un paramètre de langue "l" pour obtenir les messages d’erreur dans la langue appropriée (exemples : l=fr, l=en).

Fonctions Live

Voici la liste des fonctions Live que vous pouvez utiliser directement à l'intérieur de votre code HTML. Ces fonctions nécessitent de spécifier seulement votre clé publique et ne fonctionnent que dans les sites spécifiés dans vos paramètres.

Live/Download Autoriser les utilisateurs à télécharger un fichier vidéo directement à partir de votre site en utilisant un lien HTML. (Abonnement Or ou supérieur requis)
Live/Play Lancer la lecture d'une vidéo sur un appareil mobile (iPad, iPhone, iPod, Android). (Abonnement Argent ou supérieur requis)
Live/Thumbnail Obtenir l'image vignette d'une vidéo en utilisant une balise <IMG>. (Abonnement Argent ou supérieur requis)
Live/Upload Permettre aux utilisateurs de sélectionner un fichier vidéo sur leurs ordinateurs ou mobiles et de l'ajouter à votre compte Nimbb depuis de votre site à l'aide d'un formulaire HTML. (Abonnement Or ou supérieur requis)

Consultez notre Guide du développeur pour commencer avec Nimbb.