Cette fonctionnalité est disponible avec abonnement Standard, Advanced, Pro, Business, Premium ou Enterprise.
Vous pouvez obtenir des liens directs pour les fichiers vidéo de votre compte en utilisant l'API. L'objet de réponse vidéo peut contenir plusieurs champs pour accéder à ces fichiers, y compris la lecture, les fichierset le téléchargement. Cet article explique ce que sont ces champs et comment ils doivent être utilisés.
Sommaire de l'article :
- Ce qu'il faut savoir avant de commencer
- Comprendre les champs « lecture », « fichiers » et « téléchargement »
- Suggestions de prochaines étapes
Ce qu'il faut savoir avant de commencer
- Pour obtenir des liens directs vers les fichiers vidéo, vous devez envoyer une demande au point de fin de la vidéo à l'aide d'un jeton d'authentification ayant les portées publique, privée et de fichiers_vidéo.
- La réponse vidéo contient le fichier des champs et un lien de téléchargement.
- Les liens renvoyés dans tous ces champs sont des transferts HTTP 302 vers l'emplacement réel du fichier vidéo sur l'un de nos DNS.
- L'emplacement de ces fichiers sur nos DNS a une durée de vie et expire toutes les quelques heures, vous devez donc toujours utiliser les liens de redirection exactement tels que fournis.
- "Les fichiers HLS des vidéos mises en ligne (à l'exclusion des vidéos en direct) peuvent être téléchargés après l'optimisation et le transcodage des séquences."
Comprendre les champs « lecture », « fichiers » et « téléchargement »
Lorsque vous demandez les métadonnées d'une vidéo, la réponse peut contenir trois champs distincts pour accéder aux fichiers vidéo. Chacun a un objectif différent.
-
Lecture: ces liens sont optimisés pour la lecture et expirent après 24 heures, ce qui offre un niveau de sécurité supplémentaire.
- Nous vous recommandons d'utiliser le champ de lecture pour les lecteurs tiers.
-
Fichiers: le champ Fichiers contient des liens et des métadonnées associées, telles que les dimensions de la vidéo et la taille du fichier. Ces liens n'existent pas.
- En raison de leur durée de vie, l'utilisation de ces liens n'est pas recommandée avec les lecteurs tiers.
- Télécharger: le champ de téléchargement contient des liens expirés (valables 24 heures) vers les fichiers vidéo, ainsi que le délai d’expiration pour chaque lien et les métadonnées associées. Ces liens incluent des en-têtes qui indiquent au navigateur Web de télécharger le fichier plutôt que de le lire dans le navigateur.
Étapes suivantes :
Pour en savoir plus, consultez le Guide du développeur à API Vimeo : obtenez une vidéo spécifique, API Vimeo : lecture de la réponse et API Vimeo : réponse vidéo.