Page History
Sie können jetzt Dateien mithilfe von dynamischen URLs herunterladen, was bedeutet, dass Sie nicht mehr auf die API angewiesen sind, um den Download-Link für eine ungeschützte Datei zu finden.
Alles, was Sie benötigen, ist das URL-Schema für den Asset-Typ und dessen ID.
Wenn die Datei geschützt ist, benötigen Sie einen gültigen Token, um auf den Download-Link zuzugreifen.
Sie müssen auch die URL alle 10 Minuten erneut überprüfen, wenn der Token abläuft.
Die Tabelle unten zeigt das URL-Schema für jeden Asset-Typ.
Dynamisches Dateidownload-Schema | Anmerkungen | |
---|---|---|
Video-Quelldateien | {DOMAIN}/public/videos/{VIDEO_ID}/source | |
Video-Formatdateien | {DOMAIN}/public/videos/{VIDEO_ID}/formats/{PROFILE_KEY} | |
Vorschaubilder (Thumbnails) | {DOMAIN}/public/videos/{VIDEO_ID}/thumbnails/active?quality={QUALITY(e.g. 720p)} {DOMAIN}/public/videos/{VIDEO_ID}/thumbnails/{THUMBNAIL_ID}?quality={QUALITY(e.g. 720p)} | Beachten Sie die Optionen hier: Sie können entweder das aktive Vorschaubild angeben oder die Vorschaubild-ID angeben. Der Qualitätsparameter ist optional (standardmäßig auf 360p festgelegt). |
Kapitelvorschaubilder | {DOMAIN}/public/videos/{VIDEO_ID}/chapters/{CHAPTER_ID}/thumbnails?quality={QUALITY(e.g. 720p)} | Der Qualitätsparameter ist optional (standardmäßig auf 360p festgelegt). |
Untertitel | {DOMAIN}/public/videos/{VIDEO_ID}/subtitles/{SUBTITLE_ID}?source=VTT | Der Wert "source" gibt das Untertiteldateiformat an. Mögliche Werte sind: "SRT" oder "VTT". |
Videodateianhänge | {DOMAIN}/public/videos/{VIDEO_ID}/attachments/{TYPE_NAME}/{FILENAME} | Die Anhangtypen werden im Administrationsbereich von VideoManager Pro eingerichtet. Verwenden Sie hier den Namen des Typs, nicht die ID. Der Dateiname ist der Name der hochgeladenen Datei. Wenn diese Werte Sonderzeichen oder Leerzeichen enthalten, sollten sie URL-kodiert werden. |
Kanalanhänge | {DOMAIN}/public/channels/{CHANNEL_ID}/attachments/{TYPE_NAME}/{FILENAME} | Die Anhangtypen werden im Administrationsbereich von VideoManager Pro eingerichtet. Verwenden Sie hier den Namen des Typs, nicht die ID. Der Dateiname ist der Name der hochgeladenen Datei. Wenn diese Werte Sonderzeichen oder Leerzeichen enthalten, sollten sie URL-kodiert werden. |
Info |
---|
Dateien auf der allgemeinen Instanz der Movingimage-Plattform verwenden die folgende Domain: "https://asset-out-cdn.video-cdn.net". |
Dateischutz
Dateischutz bezieht sich auf die Fähigkeit eines Benutzers, auf Dateien auf der Movingimage-Plattform zuzugreifen. Wenn der Benutzer auf der Plattform angemeldet ist, kontrollieren die Eigentumsfunktionen von VideoManager Pro dies. Der angemeldete Benutzer kann auf Dateien gemäß seinen Rechten zugreifen. Die neue Funktion in dieser Beta betrifft jedoch den Schutz von Dateien vor Benutzern, die nicht auf der Plattform angemeldet sind.
Standardmäßig sind Dateien vor nicht angemeldeten Benutzern geschützt, indem Tokens in der Download-URL der Datei verwendet werden (Tokens sind 10 Minuten lang gültig). Die Download-URLs können über die Movingimage-Plattform-API abgerufen werden. Hier ist ein Beispiel-Download-URL für eine geschützte/private Video-Miniaturansichtsdatei:
Code Block | ||
---|---|---|
| ||
https://asset-out-cdn.video-cdn.net/private/videos/-civ9qE3JUjntKQM1HnGtU/thumbnails/78912?quality=360p&__token__=exp=1519826701~acl=***~hmac=*** |
You can now choose to turn off the protection on a file, which means anyone can access it without a token.
Code Block | ||
---|---|---|
| ||
https://asset-out-cdn.video-cdn.net/public/videos/-civ9qE3JUjntKQM1HnGtU/thumbnails/78912?quality=360p |
Hinweis: Die Dateien sind standardmäßig geschützt und können nur von einem Benutzer mit Administratorrechten in VideoManager Pro entsperrt werden. Nicht veröffentlichte Dateien sind nur über VideoManager Pro oder die API der movingimage Plattform zugänglich. Der Dateischutz kann entweder für alle Assets innerhalb eines VideoManagers oder für einen bestimmten Assettyp eines Videos oder Kanals (z. B. Thumbnail, Kapitelvorschau, Anlage, Untertitel usw.) deaktiviert werden.
Verwenden Sie die folgenden API-Endpunkte, um den Dateischutz zu deaktivieren:
VideoManager-Ebene Anfragen
Info |
---|
Sie können auch die interaktive API-Dokumentation hier finden. |
Endpoint: | /v1/vms/{videoManagerId}/security-override |
---|
Dieser Endpunkt ermöglicht es Ihnen, den Dateischutz für alle Dateien innerhalb eines VideoManagers abzurufen oder zu ändern.
HTTP Method | Request-Header | Anforderungstext | Antworttext | Beschreibung | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
GET | Authorization: Bearer "{token}" | - | Beispiel 1: Alle Dateien sind geschützt (der Geltungsbereich ist "private" und es existiert keine "public" Überschreibung für Videos, Kanäle oder Asset-Typen):
Beispiel 2: Alle Dateien sind standardmäßig geschützt, aber die Videoquell- und Formatdateien für ein Video sowie alle Asset-Typen eines Kanals sind öffentlich zugänglich.
| Holen Sie sich Details zur Dateischutz für den angegebenen VideoManager. Der VideoManager-Umfang (öffentlich oder privat) wird zusammen mit einer Liste von Video- und/oder Kanalassets zurückgegeben, die öffentlich gemacht wurden (falls vorhanden). Details finden Sie in den Beispielausgaben links. | ||||||||||||||
POST | Authorization: Bearer "{token}" | - | - | Diese Anfrage macht alle Assets innerhalb des angegebenen VideoManagers öffentlich. Sie müssen keinen Anfragekörper einschließen. | ||||||||||||||
DELETE | Authorization: Bearer "{token}" | - | - | Diese Anfrage macht alle Assets im VideoManager wieder privat/geschützt (einschließlich aller Kanal- und Video-Assets). |
Anfragen auf Asset-Ebene
Info |
---|
Sie können auch die interaktive API-Dokumentation hier finden. |
Endpoint: | /v1/vms/{videoManagerId}/asset-type/security-override |
---|
Dieser Endpunkt ermöglicht es Ihnen, den Dateischutz für bestimmte Asset-Typen auf der Ebene des VideoManagers zu entfernen.
HTTP Method | Request-Header | Anforderungstext | Beschreibung | |||||
---|---|---|---|---|---|---|---|---|
POST | Authorization: Bearer "{token}" |
| Diese Anfrage kann verwendet werden, um festzulegen, welche Asset-Typen für den gesamten VideoManager öffentlich zugänglich gemacht werden sollen. Alle möglichen Asset-Typen sind im Beispiel aufgeführt. Sie müssen mindestens einen Asset-Typ angeben. |
Anfragen auf Kanal-Ebene
Endpoint: | /v1/vms/{videoManagerId}/channels/{channelId}/security-override |
---|
Dieser Endpunkt ermöglicht es, den Dateischutz nur für einen Asset-Typ, Anhang, auf Kanalebene zu entfernen.
HTTP Method | Request-Header | Anforderungstext | Beschreibung | |||||||
---|---|---|---|---|---|---|---|---|---|---|
POST | Authorization: Bearer "{token}" |
| Diese Anfrage kann verwendet werden, um festzulegen, welche Asset-Typen innerhalb des Kanals öffentlich zugänglich sein sollen.
| |||||||
DELETE | Authorization: Bearer "{token}" | - | Verwenden Sie diese Anfrage, um alle Assets im angegebenen Kanal wieder privat/geschützt zu machen. |
Video Level Requests
Info |
---|
Sie können auch die interaktive API-Dokumentation hier finden. |
Endpoint: | /v1/vms/{videoManagerId}/videos/{videoId}/security-override |
---|
Dieser Endpunkt ermöglicht es Ihnen, den Schutz von Assets auf der Videoebene aufzuheben. Beachten Sie, dass es zwei mögliche POST-Anfragen gibt, die unterschiedlich funktionieren (Details finden Sie in der Tabelle unten):
HTTP Method | Request-Header | Anforderungstext | Beschreibung | |||||||
---|---|---|---|---|---|---|---|---|---|---|
POST | Authorization: Bearer "{token}" |
| Diese Anfrage macht alle Assets innerhalb des angegebenen Videos öffentlich. | |||||||
POST | Authorization: Bearer "{token}" |
| Diese Anfrage kann verwendet werden, um anzugeben, welche Asset-Typen innerhalb des Videos öffentlich zugänglich gemacht werden sollen.
| |||||||
DELETE | Authorization: Bearer "{token}" | - | Verwenden Sie diese Anfrage, um alle Assets im angegebenen Video wieder privat/geschützt zu machen. |