Descarga
Una Assembly puede devolver URL de descarga temporales para
los resultados del procesamiento que incluye.
Encontrarás estas URL en los resultados del Assembly Status JSON.
De forma predeterminada, se incluyen los resultados de los Steps que ningún otro Step utiliza.
Configura "result": true para incluir también los resultados de un Step intermedio.
Descarga los resultados temporales a tu propio almacenamiento en cuanto se complete la Assembly y antes de que transcurran 24 horas. Las URL de los resultados dejan de funcionar cuando caducan los archivos temporales. El almacenamiento de un resultado del procesamiento también depende de la política de retención de archivos temporales de su Template o Workspace. La retención del Assembly Status JSON es una configuración independiente y no prolonga el almacenamiento de archivos temporales.
Para los flujos de trabajo en producción, recomendamos un Robot
de exportación que guarde los resultados en tu bucket en la nube o servidor. Las exportaciones se
reintentan si fallan; de forma predeterminada, si la exportación sigue fallando tras los reintentos,
la Assembly falla en lugar de informar de una exportación exitosa. El acceso a los archivos de tu
propio almacenamiento depende de ese proveedor y de tu configuración. Revisa el valor predeterminado
de acl del Robot de exportación: algunas exportaciones son públicas a menos
que configures el acceso privado. La guía de Google Cloud Storage y la
guía de DigitalOcean Spaces muestran configuraciones privadas.
Las URL temporales (tmp-*.transloadit.net) son exclusivamente para descargar los archivos una sola vez y guardarlos en tu propio almacenamiento:
- ✅ Permitido: descargar el archivo una sola vez y almacenarlo en tu infraestructura
- ❌ No permitido: compartir URL temporales con tus usuarios finales (infringe los Términos del servicio (English))
- ❌ No permitido: insertar URL temporales en tu aplicación o sitio web
- ❌ No permitido: usarlas como CDN o para realizar descargas repetidas
Infringir estas restricciones constituye un incumplimiento de nuestros Términos del servicio y puede provocar la suspensión inmediata de la cuenta. Se prohíbe acceder a los archivos más de 10 veces o consumir un ancho de banda excesivo. Para el uso en producción, usa siempre un Robot de exportación a fin de guardar los archivos en tu propio almacenamiento.
🤖/file/filter pasa los archivos aceptados a los Steps posteriores y no
incluye los archivos rechazados en sus resultados. Este Robot reutiliza la información de la URL del
archivo de entrada en lugar de crear otra copia almacenada temporalmente. De forma predeterminada,
las subidas se almacenan temporalmente; al filtrar una subida, el Robot reutiliza esa copia existente
sin prolongar su vida útil. La salida de un Step de procesamiento que alimenta al filtro no se
conserva en el almacenamiento temporal de forma predeterminada, por lo que una URL que funciona no
basta para determinar cuánto tiempo seguirá disponible esa salida. Para solicitar el almacenamiento
temporal, configura "result": true en el Step que produce la salida. Esto también
incluye los resultados sin filtrar de ese Step en el Assembly Status JSON y sigue sujeto a tu
política de retención. Para guardar solo los archivos aceptados en tu propio almacenamiento,
conecta un Step de exportación al Step de filtrado.
Para la entrega mediante Smart CDN, sigue la guía de configuración de Smart CDN. Las URL de descarga temporales no sustituyen a Smart CDN ni a tu propio alojamiento.
