Zum Hauptinhalt gehen

Informationen zu Download-Links für Videodateien über die API

Für diese Funktion ist ein Standard-, Advanced-, Pro-, Business-, Premium- oder Enterprise-Tarif erforderlich.

Sie können über die API direkte Links zu Videodateien aus Ihrem Konto abrufen. Das Videoantwortobjekt kann mehrere Felder für den Zugriff auf diese Dateien enthalten, darunter play, filesund download. Dieser Artikel erklärt, was diese Felder sind und wie sie verwendet werden sollten.

In diesem Artikel:

Was Sie vor Beginn wissen sollten

  • Um direkte Videodateilinks zu erhalten, müssen Sie eine Anfrage an den Endpunkt des Videos senden, wobei Sie ein Authentifizierungstoken verwenden, das die Bereiche öffentlich, privat und video_files besitzt.
    • Die Videoantwort enthält die Felddatei und einen Download-Link.
  • Die in all diesen Feldern zurückgegebenen Links sind HTTP 302-Weiterleitungen zum eigentlichen Speicherort der Videodatei auf einem unserer CDNs. 
    • Die Speicherorte dieser Dateien auf unseren CDNs haben eine begrenzte Gültigkeitsdauer und laufen alle paar Stunden ab. Daher müssen Sie die Weiterleitungslinks immer genau so verwenden, wie sie angegeben sind.
  • HLS-Dateien für hochgeladene Videos (ausgenommen Live-Videos) können heruntergeladen werden, nachdem das Bildmaterial optimiert und umkodiert wurde.

Die Felder „Play“, „Files“ und „Download“ verstehen

Wenn Sie die Metadaten eines Videos anfordern, kann die Antwort drei verschiedene Felder für den Zugriff auf Videodateien enthalten. Jedes dient einem anderen Zweck.

  • Wiedergabe: Diese Links sind für die Wiedergabe optimiert und laufen nach 24 Stunden ab, wodurch eine zusätzliche Sicherheitsebene geschaffen wird.
    • Wir empfehlen die Nutzung des Spielfelds für Drittanbieter-Player. 
  • Dateien: Das Feld „Dateien“ enthält Links und zugehörige Metadaten, wie z. B. die Abmessungen und die Dateigröße des Videos. Diese Links sind unbegrenzt gültig.
    • Da diese Links nicht ablaufen, wird von der Verwendung mit Drittanbieter-Playern abgeraten.
  • Download: Das Downloadfeld enthält zeitlich begrenzte Links (gültig für 24 Stunden) zu den Videodateien, zusammen mit der jeweiligen Ablaufzeit und zugehörigen Metadaten. Diese Links enthalten Header, die dem Webbrowser mitteilen, die Datei herunterzuladen, anstatt sie im Browser abzuspielen.

Empfohlene nächste Schritte:

Weitere Informationen finden Sie im Entwicklerhandbuch unter Vimeo API: Ein bestimmtes Video abrufen, Vimeo API: Wiedergabeantwort und Vimeo API: Videoantwort.

Verwandte Beiträge