ads

Une API REST pour votre plateforme de streaming

Pilotez le catalogue, les visuels, les chaînes en direct, le merchandising et les rapports grâce à une API REST calquée sur l'espace d'administration.

L'appel « Add New Video » dans la documentation API de la plateforme sur un ordinateur portable, avec le même titre ouvert dans une application mobile

Visuels et chaînes en direct par API

Avec l'API Vodlix, les visuels sont associés par URL au lieu d'être importés à la main. Un appel définit les images portrait, paysage et logo d'un titre, un autre choisit l'image générée qui sert de miniature. Les chaînes en direct sont gérées comme les vidéos : créées à partir d'une URL de flux, mises à jour, publiées ou dépubliées, mises à la corbeille ou restaurées, si bien que le contenu linéaire s'automatise comme la VOD. Pour un catalogue volumineux ou qui change souvent, les visuels restent cohérents sans que personne n'ait à importer les fichiers un par un.


Documentation API de « Update Content Thumbs », qui définit les visuels portrait, paysage et logo d'un titre à partir d'URL d'images
Rest icon
API REST

Familière et prévisible.

Mirror icon
Calquée sur l'admin

Si vous connaissez l'interface, vous connaissez l'API.

Full icon
Cycle de vie complet

Créer, publier, dépublier, restaurer.

Gérer le catalogue par programmation

L'API REST Vodlix vous permet de piloter le catalogue par programmation, à l'image de l'espace d'administration. Les vidéos peuvent être créées, mises à jour, publiées ou dépubliées, mises à la corbeille ou restaurées. Les séries et les saisons sont créées, mises à jour et publiées de la même façon, et les épisodes sont rattachés à une saison ou en sont détachés. Les nouvelles vidéos sont ingérées en fournissant à la plateforme l'URL d'un fichier, public ou stocké dans votre propre espace S3 ou Wasabi : elle récupère et traite le fichier en arrière-plan, puis renvoie un identifiant vidéo pour en suivre l'avancement. Pour les opérateurs OTT dotés de systèmes existants, la gestion du catalogue peut être automatisée au lieu d'être faite à la main.


Documentation API de « Upload with URL », qui ingère une vidéo depuis l'URL d'un fichier stocké en accès public, sur S3 ou sur Wasabi
Page d'accueil de la vitrine avec les rangées « Top 10 » et « Rent the Latest », des listes de contenus qu'un appel API peut activer ou désactiver

Merchandising et listes de contenus pilotés par API

L'API Vodlix vous donne la main sur le merchandising : listes de contenus, groupes de listes, leurs éléments et leur ordre peuvent tous être créés et gérés par programmation. Les listes s'activent et se désactivent, si bien qu'une rangée saisonnière se coupe par un appel API au lieu d'être reconstruite. Les systèmes de programmation et les outils de planification éditoriale peuvent ainsi composer la page d'accueil automatiquement. C'est ce pilotage du merchandising par API qui permet aux workflows éditoriaux de passer à l'échelle.


Endpoints de référence et de reporting

L'API Vodlix propose des appels de référence et de reporting : identifiants de catégorie, nombre de contenus et d'utilisateurs, récapitulatif des ventes sur n'importe quelle période et informations sur la plateforme comme la version du logiciel. Les intégrations savent toujours sur quoi elles travaillent et peuvent s'adapter aux évolutions de la plateforme. L'accès repose sur des clés API créées dans l'admin : une clé serveur pour les tâches back-end et une clé client pour le code navigateur, qui ne peut jamais atteindre les routes d'administration. Les mêmes appels sont exposés aux assistants IA via le connecteur MCP de la plateforme.


Tableau des outils MCP Access : infos de la plateforme, nombre de contenus et d'utilisateurs, navigation dans le catalogue et récapitulatif des ventes

Là où elle fait vraiment la différence

Les cas les plus courants sont la migration, l'ingestion et le reporting. Transférer un catalogue depuis une autre plateforme devient une tâche API plutôt qu'un travail manuel, et c'est toute la différence entre un lancement qui n'attend personne et un lancement qui se compte en mois. L'ingestion récurrente depuis un distributeur ou un workflow de production tourne sans surveillance une fois écrite. Le reporting envoie les chiffres dans les outils que votre équipe financière utilise déjà, au lieu de demander à quelqu'un d'exporter un écran chaque lundi.


Elle relie aussi votre plateforme au reste de votre activité. Envoyez un nouveau titre vers votre CMS et votre site marketing dès sa publication, ou transmettez vos listes de contenus à un service de recommandation et réinjectez les résultats. Lorsqu'une intégration demande plus que ce que l'API seule permet, notre service de plugins sur mesure développe la pièce manquante sur la même plateforme.


Les statistiques sont accessibles via l'API lorsqu'un service de statistiques est configuré sur votre cloud ; mieux vaut le vérifier dès la mise en place que le découvrir plus tard. La page rapports et statistiques détaille ce qui est mesuré.


Questions Fréquemment Posées

Vous avez des questions sur la façon de profiter de cette offre à durée limitée ? Consultez la FAQ pour obtenir des réponses.

Que peut piloter l'API REST Vodlix ?
L'API REST Vodlix pilote le catalogue (vidéos, séries, saisons et épisodes), ainsi que les visuels, les chaînes en direct, les listes de contenus et le merchandising, et les données de référence et de reporting.
Dois-je importer les fichiers vidéo via l'API Vodlix ?
Les nouvelles vidéos sont ingérées via l'API Vodlix en fournissant une URL HTTPS publique. Vodlix récupère et transcode le fichier : vous n'avez donc pas à faire transiter des fichiers binaires par votre propre infrastructure.
L'API Vodlix reflète-t-elle l'espace d'administration ?
Oui. L'API REST Vodlix reflète l'espace d'administration, avec des conventions REST familières et des réponses prévisibles : quiconque connaît l'interface sait à peu près ce que l'API peut faire.
Puis-je gérer les listes de contenus via l'API Vodlix ?
Oui. Les listes de contenus Vodlix, les groupes de listes, leurs éléments et leur ordre peuvent tous être créés, mis à jour, activés et désactivés via l'API, ce qui permet d'automatiser le merchandising.
Quelles données de reporting l'API Vodlix fournit-elle ?
L'API Vodlix fournit le nombre de contenus et d'utilisateurs, un récapitulatif des ventes sur une période donnée, les identifiants de catégorie et des informations sur la plateforme comme la version du logiciel, pour que les intégrations sachent toujours sur quoi elles travaillent.
Les identifiants de catégorie sont-ils les mêmes sur chaque cloud Vodlix ?
Non, et c'est l'erreur la plus courante. Les catégories sont propres à chaque cloud : lisez la liste des catégories de la plateforme sur laquelle vous travaillez et utilisez les identifiants qu'elle renvoie, au lieu de supposer qu'un nom correspond partout au même numéro.
Pouvons-nous obtenir des statistiques via l'API ?
Oui, lorsqu'un service de statistiques est configuré sur votre cloud : chiffres clés, activité en temps réel et contenus les plus performants. Mieux vaut le confirmer lors de la mise en place, car ce service est provisionné séparément des opérations sur le catalogue.
L'API est-elle utile pour migrer depuis une autre plateforme ?
C'est l'une des raisons les plus fréquentes pour lesquelles les opérateurs l'utilisent. Transférer un catalogue par programmation fait d'une migration une tâche reproductible plutôt que des mois de saisie manuelle, et elle peut être relancée pour rattraper tout ce qui a changé pendant le transfert.
Comment les intégrations s'authentifient-elles auprès de l'API Vodlix ?
Avec une clé API créée dans l'admin sous « Apps & APIs » et envoyée dans l'en-tête X-Api-Key. Une clé serveur agit avec les permissions de l'utilisateur auquel elle appartient et peut atteindre les routes d'administration : elle a donc sa place sur un back-end. Une clé client peut être utilisée sans risque dans le code navigateur et est bloquée sur toutes les routes d'administration. Les clés peuvent avoir une date d'expiration, et supprimer une clé la révoque immédiatement.