AssetFeed: Bilder direkt in externe Systeme ausliefern

Mit dem Add-on AssetFeed stellst du ausgewählte Bilder aus VAULO anderen Systemen zur Verfügung – zum Beispiel deiner Website, einem Shop, einem CMS oder einer Partner-App. Der Feed ist eine öffentliche URL ohne Anmeldung, die eine JSON-Liste deiner veröffentlichten Assets liefert. Die Bilder selbst werden über ein URL-Schema abgerufen, das du selbst festlegst. Wie das JSON aussieht, bestimmst du mit einem Template.

So funktioniert AssetFeed (Überblick)

1. AssetFeed anlegen (Titel und Pfad der Feed-URL)
2. Endpunkte, URL-Schema und JSON-Template konfigurieren
3. Dateien im Feed veröffentlichen
4. Das externe System ruft die Feed-URL ab und lädt die Bilder über die Asset-URLs

Add-on aktivieren und öffnen

Um einen AssetFeed anzulegen, brauchst du Adminrechte in deiner Organisation. Du findest das Add-on unter Einstellungen → Add-Ons → AssetFeed. Klicke auf Verwalten, um die Übersicht deiner Feeds zu öffnen. Beim ersten Aufruf wirst du aufgefordert, das Add-on zu aktivieren.

AssetFeed erstellen

Klicke in der Übersicht auf AssetFeed erstellen und fülle die beiden Felder aus:

• Titel – der Name des Feeds, wie er in VAULO und im JSON (feed.title) erscheint, zum Beispiel Pressebilder.
• Feed-URL – der Pfad hinter deinem Organisationsnamen, zum Beispiel presse. Der Pfad muss innerhalb deiner Organisation eindeutig sein.

Heißt deine Organisation in VAULO mustermann, ist der Feed anschließend unter https://share.vaulo.com/mustermann/presse erreichbar. Hast du eine eigene Domain wie media.mustermann.ag mit VAULO verknüpft, lautet die Adresse https://media.mustermann.ag/presse.

Direkt nach dem Erstellen öffnet sich der Dialog AssetFeed anpassen. Ein neuer Feed bringt bereits eine funktionierende Standardkonfiguration mit: eine API mit einem Listen-Endpunkt auf der Feed-URL und einem Einzel-Asset-Endpunkt mit dem URL-Schema assets/{filename}. Du kannst also sofort Dateien veröffentlichen und den Feed testen. Mit Kopieren neben der Feed-URL landet die Adresse in deiner Zwischenablage.

Dateien veröffentlichen

Ein Feed liefert ausschließlich Dateien aus, die du darin veröffentlicht hast. Dafür gibt es zwei Wege:

1. Über den Teilen-Dialog: Wähle eine oder mehrere Dateien aus, öffne Teilen und wechsle auf den Reiter AssetFeed. Hake die gewünschten Feeds an und klicke auf In AssetFeeds veröffentlichen. Der Reiter erscheint nur, wenn das Add-on aktiv ist und mindestens ein Feed existiert.
2. In den Dateidetails: Im Abschnitt AssetFeed siehst du alle Feeds deiner Organisation mit einem Schalter Veröffentlicht. Hier nimmst du eine Datei auch wieder aus einem Feed heraus.

Nicht veröffentlichte Dateien sind über den Feed nicht erreichbar – der Feed verrät auch nicht, ob es sie gibt.

Zugriff und Sicherheit

• Öffentlich, ohne Passwort. Ein AssetFeed richtet sich an Maschinen, die kein Passwort eingeben können. Ein Passwortschutz ist für diesen Freigabetyp deshalb nicht vorgesehen.
• Gültigkeitszeitraum. Wie bei anderen Freigaben kannst du einen Zeitraum festlegen. Außerhalb davon antwortet der Feed mit dem Statuscode 401.
• Asset-URLs sind zeitlich begrenzt. Die url-Werte im JSON zeigen direkt auf die Bilddateien und laufen nach der eingestellten Gültigkeit ab. Ein externes System sollte die Feed-URL regelmäßig neu abrufen, statt die Bild-URLs dauerhaft zu speichern. Dauerhaft adressierbar sind die Bilder über dein URL-Schema, zum Beispiel …/presse/assets/sommerfest.jpg.
• Aufrufe. Jeder Abruf der Feed-URL zählt als ein Aufruf der Freigabe – unabhängig davon, wie viele Bilder das externe System anschließend lädt.

Weiterlesen