Télécharger
Une Assembly peut renvoyer des URL de téléchargement
temporaires pour les résultats de traitement qu’elle inclut.
Vous trouverez ces URL dans les résultats de l’Assembly Status JSON.
Par défaut, les résultats sont inclus pour les Steps qu’aucun autre Step n’utilise. Définissez
"result": true pour inclure également les résultats d’un Step intermédiaire.
Téléchargez les résultats temporaires vers votre propre stockage dès que l’Assembly se termine, et dans un délai de 24 heures. Les URL des résultats cessent de fonctionner après l’expiration des fichiers temporaires. Le stockage d’un résultat de traitement dépend également de la politique de conservation des fichiers temporaires de son Template ou de son Workspace. La conservation de l’Assembly Status JSON est un réglage distinct qui ne prolonge pas la durée de stockage des fichiers temporaires.
Pour les flux de travail en production, nous recommandons un Robot
d’exportation qui enregistre les résultats dans votre bucket cloud ou sur votre serveur. Les
exportations font l’objet de nouvelles tentatives en cas d’échec ; par défaut, si l’exportation
échoue toujours après ces tentatives, l’Assembly échoue au lieu de signaler une exportation réussie.
L’accès aux fichiers de votre propre stockage est régi par ce fournisseur et votre configuration.
Vérifiez la valeur par défaut du paramètre acl du Robot d’exportation :
certaines exportations sont publiques, sauf si vous configurez un accès privé. Le
guide Google Cloud Storage et le
guide DigitalOcean Spaces présentent des configurations privées.
Les URL temporaires (tmp-*.transloadit.net) servent strictement à télécharger les fichiers une seule fois vers votre propre stockage :
- ✅ Autorisé : Télécharger le fichier une seule fois et le stocker sur votre infrastructure
- ❌ Interdit : Partager les URL temporaires avec vos utilisateurs finaux (enfreint les conditions d’utilisation (English))
- ❌ Interdit : Intégrer les URL temporaires dans votre application ou votre site web
- ❌ Interdit : Les utiliser comme CDN ou pour des téléchargements répétés
Tout manquement à ces restrictions enfreint nos conditions d’utilisation et peut entraîner la suspension immédiate du compte. Les fichiers consultés plus de 10 fois ou consommant une bande passante excessive sont interdits. Utilisez toujours un Robot d’exportation pour enregistrer les fichiers dans votre propre stockage pour une utilisation en production.
Le Robot 🤖/file/filter transmet les fichiers acceptés aux Steps
suivants et ne renvoie pas les fichiers rejetés dans ses résultats. Il réutilise les informations
d’URL du fichier d’entrée au lieu de créer une autre copie stockée temporairement. Par défaut, les
fichiers téléversés bénéficient d’un stockage temporaire ; leur filtrage réutilise cette copie
existante sans prolonger sa durée de vie. La sortie d’un Step de traitement qui alimente le filtre
n’est pas conservée dans le stockage temporaire par défaut. Une URL fonctionnelle ne suffit donc
pas à déterminer combien de temps cette sortie restera disponible. Pour demander un stockage
temporaire, définissez "result": true sur le Step qui produit cette sortie. Cela
inclut également les résultats non filtrés de ce Step dans l’Assembly Status JSON et reste soumis
à votre politique de conservation. Pour enregistrer uniquement les fichiers acceptés dans votre
propre stockage, connectez plutôt un Step d’exportation au Step de filtrage.
Pour la diffusion via le Smart CDN, suivez le guide de configuration du Smart CDN. Les URL de téléchargement temporaires ne remplacent pas le Smart CDN ni votre propre hébergement.