--- title: "Dynamischer Download und Dateischutz" slug: "dynamic-download-and-file-protection" updated: 2025-04-23T09:46:16Z published: 2025-04-23T09:46:16Z canonical: "help.movingimage.com/dynamic-download-and-file-protection" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.movingimage.com/llms.txt > Use this file to discover all available pages before exploring further. # 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: | Asset Typ | URL Schema | | --- | --- | | Video-Quelldateien | `{DOMAIN}/public/videos/{VIDEO_ID}/source` | | Video-Formatdateien | `{DOMAIN}/public/videos/{VIDEO_ID}/formats/{PROFILE_KEY}` | | Thumbnails | `{DOMAIN}/public/videos/{VIDEO_ID}/thumbnails/{THUMBNAIL_ID}?quality={QUALITY}` | | Kapitel Thumbnails | `{DOMAIN}/public/videos/{VIDEO_ID}/chapters/{CHAPTER_ID}/thumbnails?quality={QUALITY}` | | Untertitel | `{DOMAIN}/public/videos/{VIDEO_ID}/subtitles/{SUBTITLE_ID}?source=VTT` | | Video Anhänge | `{DOMAIN}/public/videos/{VIDEO_ID}/attachments/{TYPE_NAME}/{FILENAME}` | | Channel Anhänge | `{DOMAIN}/public/channels/{CHANNEL_ID}/attachments/{TYPE_NAME}/{FILENAME}` | Der {DOMAIN} Platzhalter sollte durch die Domain der movingimage Plattform ersetzt werden. Die Standarddomäne ist https://asset-out-cdn.video-cdn.net. 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:** ```plainText 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: ```plainText 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](https://developers.movingimage.com/) 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: ```plainText {  "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: ```plainText {  "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: ```plainText {  "scope": "public" } ``` - Diese Anfrage macht alle Assets innerhalb des angegebenen Videos öffentlich. **POST #2:** - Authorization: Bearer "{token}" - Body: ```plainText {  "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}"