Dynamischer Download und Dateischutz

Dynamischer Dateidownload

Dateien können jetzt über dynamische URLs heruntergeladen werden. Das bedeutet, dass Sie die Datei finden können, wenn Sie das URL-Schema des Asset-Typs kennen und über Informationen über das Asset verfügen, wie z. B. seine ID.

In der folgenden Tabelle finden Sie das dynamische URL-Schema für jeden Asset-Typ:

Der {VIDEO_ID} Platzhalter sollte durch die ID des Videos oder Kanals ersetzt werden, zu dem das Asset gehört.

Der {THUMBNAIL_ID} Platzhalter sollte durch die ID des Thumbnails ersetzt werden, falls zutreffend.

Der {CHAPTER_ID} Platzhalter sollte durch die ID des Kapitels ersetzt werden, falls zutreffend.

Der {TYPE_NAME} Platzhalter sollte durch den Namen des Anlagentyps ersetzt werden.

Der {FILENAME} Platzhalter sollte durch den Namen der Datei ersetzt werden.

Der {QUALITY} Platzhalter ist optional und kann verwendet werden, um die Qualität der Miniaturansicht oder der Untertiteldatei anzugeben. Die Standardqualität ist 360p.

Dateischutz

Standardmäßig werden Dateien vor nicht angemeldeten Benutzern durch die Verwendung von Token geschützt, die in der Download-URL der Datei enthalten sind. Die Download-URLs können über die movingimage Platform API bezogen werden.

Dateien auf der movingimage Plattform schützen

Der Dateischutz auf der movingimage Plattform kontrolliert die Möglichkeit eines Benutzers, auf Dateien zuzugreifen. Wenn ein Benutzer eingeloggt ist, bestimmen die VideoManager Pro Eigentumsfunktionen die Zugriffsrechte. Dieses neue Beta-Feature adressiert den Dateischutz für nicht eingeloggte Benutzer.

Standardmäßig werden Dateien vor nicht eingeloggten Benutzern durch Token in der Download-URL der Datei geschützt (gültig für 120 Minuten). Diese URLs können von der movingimage Platform API bezogen werden.

Beispiel Download-URL für eine geschützte Video-Thumbnail-Datei:

https://asset-out-cdn.video-cdn.net/private/videos/-civ9qE3JUjntKQM1HnGtU/thumbnails/78912?quality=360p&__token__=exp=1519826701acl=***hmac=***

Der Dateischutz kann deaktiviert werden, um den öffentlichen Zugriff ohne Token zu ermöglichen:

https://asset-out-cdn.video-cdn.net/public/videos/-civ9qE3JUjntKQM1HnGtU/thumbnails/78912?quality=360p

Ungeschützte Dateien verwenden "/public/" anstelle von "/private/" und haben kein Token.

Wichtige Punkte:

• Alle Dateien sind standardmäßig geschützt. Um den Schutz zu deaktivieren, sind Administratorrechte in VideoManager Pro erforderlich.

• Unveröffentlichte Dateien sind nur über VideoManager Pro oder die movingimage Platform API zugänglich.

• Der Dateischutz kann für alle Assets oder für bestimmte Asset-Typen (Thumbnails, Kapitel-Thumbnails, Anhänge, Untertitel, etc.) deaktiviert werden.

Um den Dateischutz zu aktivieren oder zu deaktivieren, können Sie die folgenden API endpoints verwenden:

Verwalten des Dateischutzes auf der movingimage Plattform

Anfragen auf VideoManager-Ebene

• Endpoint: /v1/vms/{videoManagerId}/security-override

• Verwenden Sie diesen Endpunkt, um den Dateischutz für alle Dateien innerhalb eines VideoManagers zu verwalten.

GET:

• Authorization: Bearer "{token}"

• Beispiel 1: Alle Dateien sind geschützt (Geltungsbereich ist „privat“, und es gibt keine „öffentliche“ Überschreibung für Videos, Kanäle oder Asset-Typen).

• Beispiel 2: Alle Dateien sind generell geschützt, aber die Videoquelle und die Formatdateien für ein Video sind öffentlich, und alle Asset-Typen eines Channels sind öffentlich.

• Rufen Sie Details zum Dateischutz für den angegebenen VideoManager ab. Der VideoManager-Bereich (öffentlich oder privat) wird zusammen mit einer Liste der Video- und/oder Kanal-Assets zurückgegeben, die öffentlich gemacht wurden (falls vorhanden). Weitere Informationen finden Sie in den Beispielantworten auf der linken Seite.

POST:

• Authorization: Bearer "{token}"

• Mit dieser Anforderung werden alle Elemente im angegebenen VideoManager veröffentlicht. Sie müssen keinen Anforderungstext einfügen.

DELETE:

• Authorization: Bearer "{token}"

• Mit dieser Anforderung werden alle Elemente im VideoManager wieder privat/geschützt (einschließlich aller Channel- und Videoelemente).

Anfragen auf Asset-Ebene

• Endpoint: /v1/vms/{videoManagerId}/asset-type/security-override

• Verwenden Sie diesen Endpunkt, um den Dateischutz für bestimmte Asset-Typen auf VideoManager-Ebene aufzuheben.

POST:

• Authorization: Bearer "{token}"

• Body:

{
  "assetTypes": [
    "VIDEO_SOURCE",
    "VIDEO_FORMAT",
    "STILL_SOURCE",
    "STILL_RESOLUTION",
    "SUBTITLE",
    "ATTACHMENT"
  ]
}

• Diese Anforderung gibt an, welche Asset-Typen für den gesamten VideoManager öffentlich gemacht werden sollen. Alle möglichen Asset-Typen sind im Beispiel aufgeführt. Sie müssen mindestens einen Anlagentyp angeben.

Anfragen auf Channelebene

• Endpoint: /v1/vms/{videoManagerId}/channels/{channelId}/security-override

• Verwenden Sie diesen Endpunkt, um den Dateischutz für nur einen Asset-Typ, den Anhang, auf Channel-Ebene aufzuheben.

POST:

• Authorization: Bearer "{token}"

• Body:

{
  "assetTypes": [
    "ATTACHMENT"
  ]
}

• Diese Anfrage gibt an, welche Asset-Typen innerhalb des Channels öffentlich gemacht werden sollen. Channels unterstützen derzeit nur den Asset-Typ „attachment“.

DELETE:

• Authorization: Bearer "{token}"

• Verwenden Sie diese Anfrage, um alle Assets im angegebenen Channel wieder privat/geschützt zu machen.

Anfragen auf Videoebene

• Endpoint: /v1/vms/{videoManagerId}/videos/{videoId}/security-override

• Verwenden Sie diesen Endpunkt, um den Dateischutz für Assets auf Videoebene aufzuheben. Beachten Sie, dass es zwei mögliche POST-Anfragen gibt, die unterschiedlich funktionieren (siehe Details in der Tabelle unten).

POST #1:

• Authorization: Bearer "{token}"

• Body:

{
  "scope": "public"
}

• Diese Anfrage macht alle Assets innerhalb des angegebenen Videos öffentlich.

POST #2:

• Authorization: Bearer "{token}"

• Body:

{
  "assetTypes": [
    "VIDEO_SOURCE",
    "VIDEO_FORMAT",
    "STILL_SOURCE",
    "STILL_RESOLUTION",
    "SUBTITLE",
    "ATTACHMENT"
  ]
}

• Diese Anforderung gibt an, welche Asset-Typen im Video veröffentlicht werden sollen. Alle möglichen Asset-Typen sind im Beispiel aufgeführt. Sie müssen mindestens einen Anlagentyp angeben.

DELETE:

• Authorization: Bearer "{token}"