Herunterladen
Eine Assembly kann temporäre Download-URLs für die
enthaltenen Verarbeitungsergebnisse zurückgeben.
Sie finden diese URLs in den Ergebnissen im Assembly Status JSON.
Standardmäßig sind Ergebnisse für Steps enthalten, die kein anderer Step verwendet. Setzen Sie
"result": true, um auch die Ergebnisse eines zwischengeschalteten Steps einzuschließen.
Laden Sie temporäre Ergebnisse in Ihren eigenen Speicher herunter, sobald die Assembly abgeschlossen ist, spätestens jedoch innerhalb von 24 Stunden. Ergebnis-URLs funktionieren nach Ablauf der Aufbewahrungsdauer der temporären Dateien nicht mehr. Ob ein Verarbeitungsergebnis gespeichert wird, hängt auch von der Aufbewahrungsrichtlinie für temporäre Dateien ab, die für das zugehörige Template oder den Workspace gilt. Für das Assembly Status JSON gilt eine separate Aufbewahrungseinstellung, die die Speicherung temporärer Dateien nicht verlängert.
Für Produktionsabläufe empfehlen wir einen Robot für den Export,
der Ergebnisse in Ihrem Cloud-Bucket oder auf Ihrem Server speichert. Fehlgeschlagene Exporte werden
erneut versucht. Schlägt der Export auch nach den Wiederholungsversuchen fehl, schlägt standardmäßig
die Assembly fehl, anstatt einen erfolgreichen Export zu melden.
Der Zugriff auf Dateien in Ihrem eigenen Speicher wird durch den Anbieter und Ihre Konfiguration
bestimmt. Prüfen Sie beim Export-Robot den Standardwert für acl: Manche
Exporte sind öffentlich, sofern Sie keinen privaten Zugriff konfigurieren. Die
Anleitung für Google Cloud Storage und die
Anleitung für DigitalOcean Spaces zeigen private Konfigurationen.
Temporäre URLs (tmp-*.transloadit.net) sind ausschließlich zum einmaligen Herunterladen von Dateien in Ihren eigenen Speicher bestimmt:
- ✅ Erlaubt: Die Datei einmal herunterladen und auf Ihrer Infrastruktur speichern
- ❌ NICHT erlaubt: Temporäre URLs mit Ihren Endnutzern teilen (verstößt gegen die Nutzungsbedingungen (English))
- ❌ NICHT erlaubt: Temporäre URLs in Ihre Anwendung/Website einbetten
- ❌ NICHT erlaubt: Als CDN oder für wiederholte Downloads verwenden
Verstöße gegen diese Einschränkungen verletzen unsere Nutzungsbedingungen und können zur sofortigen Kontosperrung führen. Dateien, auf die mehr als 10 Mal zugegriffen wird oder die übermäßig viel Bandbreite verbrauchen, sind untersagt. Verwenden Sie im Produktionsbetrieb immer einen Robot für den Export, um Dateien in Ihrem eigenen Speicher abzulegen.
🤖/file/filter gibt akzeptierte Dateien an nachfolgende Steps weiter und
gibt abgelehnte Dateien nicht als Ergebnisse aus. Der Robot verwendet die URL-Informationen der
Eingabedatei weiter, anstatt eine weitere temporär gespeicherte Kopie zu erstellen. Standardmäßig
werden Uploads temporär gespeichert. Beim Filtern eines Uploads wird diese vorhandene Kopie
weiterverwendet, ohne ihre Lebensdauer zu verlängern. Die Ausgabe eines verarbeitenden Steps, der
Dateien an den Filter übergibt, wird standardmäßig nicht im temporären Speicher aufbewahrt. Aus einer
funktionierenden URL allein lässt sich daher nicht ableiten, wie lange diese Ausgabe verfügbar
bleibt. Um temporäre Speicherung anzufordern, setzen Sie "result": true für den Step,
der die Ausgabe erzeugt. Dadurch werden auch die ungefilterten Ergebnisse dieses Steps in das
Assembly Status JSON aufgenommen. Die Speicherung unterliegt weiterhin Ihrer Aufbewahrungsrichtlinie.
Um nur akzeptierte Dateien in Ihrem eigenen Speicher abzulegen, verbinden Sie stattdessen einen
Export-Step mit dem Filter-Step.
Für die Auslieferung über Smart CDN folgen Sie der Anleitung zur Einrichtung von Smart CDN. Temporäre Download-URLs sind kein Ersatz für Smart CDN oder Ihr eigenes Hosting.