
Import files from web servers
🤖/http/import imports any file that is publicly available via a web URL into Transloadit.
The result of this Robot will carry a field import_url
in their metadata, which
references the URL from which they were imported. Further conversion results that use this file will
also carry this import_url
field. This allows you to to match conversion results with the original
import URL that you used.
This Robot knows to interpret links to files on these services:
- Dropbox
- Google Drive
- Google Docs
- OneDrive
Instead of downloading the HTML page previewing the file, the actual file itself will be imported.
Parameters
-
ignore_errors
Array of Strings / Boolean ⋅ default:[]
Possible array members are
"meta"
and"import"
.You might see an error when trying to extract metadata from your imported files. This happens, for example, for files with a size of zero bytes. Including
"meta"
in the array will cause the Robot to not stop the import (and the entire Assembly) when that happens.Including
"import"
in the array will ensure the Robot does not cease to function on any import errors either.To keep backwards compatibility, setting this parameter to
true
will set it to["meta", "import"]
internally. -
url
String / Array of StringsrequiredThe URL from which the file to be imported can be retrieved.
You can also specify an array of URLs or a string of
|
delimited URLs to import several files at once. Please also check theurl_delimiter
parameter for that. -
url_delimiter
String ⋅ default:"|"
Provides the delimiter that is used to split the URLs in your
url
parameter value. -
headers
Array of Strings ⋅ default:[]
Custom headers to be sent for file import.
This is an empty array by default, such that no additional headers except the necessary ones (e.g. Host) are sent.
-
force_name
String / Array of Strings / Null ⋅ default:null
Custom name for the imported file(s). Defaults to
null
, which means the file names are derived from the supplied URL(s). -
import_on_errors
Array of Strings ⋅ default:[]
Setting this to
"meta"
will still import the file on metadata extraction errors.ignore_errors
is similar, it also ignores the error and makes sure the Robot doesn't stop, but it doesn't import the file. -
fail_fast
Boolean ⋅ default:false
Disable the internal retry mechanism, and fail immediately if a resource can't be imported. This can be useful for performance critical applications.
Demos
- Fade effect between concatenated audio tracks
- Concatenate two audio files
- Add watermark to a song
- Insert cover art into an audio file
- Add an empty audio track to still video
- Encode a fade effect between concatenated video files.
- Concatenate video files
- Generate a slideshow from a series of images
- Generate a video from an image sequence
- Insert an ad into a video at a specific time
- Merge an audio and a video file
- Merge an audio file and an image to generate a video
Related blog posts
- Adding Support for Audio Encoding November 21, 2011
- Two Small Feature Updates February 11, 2012
- Last Night's Elevated Queue Times March 31, 2012
- Announcing the Assembly Notification System April 8, 2013
- API Updates and jQuery SDK Version 2.3.0 November 29, 2013
- New Robot for Virus Detection July 21, 2015
- Raising prices (for new customers) February 7, 2018
- Launching Turbo Mode in public beta November 15, 2018
- An introduction to the Subtitle Robot December 6, 2018
- Tutorial: Using /video/merge to develop video slideshows June 14, 2019
- Add real-time video uploading to a site without writing code, with Bubble.is and Transloadit August 2, 2019
- Convert Markdown to HTML (and PDF) April 19, 2021
- Fast failing for the /http/import Robot June 1, 2021
- Let's Build: Animated Spinning Record GIF Generator April 1, 2021
- Let's Build: a video from album art October 10, 2021
- Transloadit Milestones of 2021 January 31, 2022
- Let's Build: Reddit video subtitling bot February 10, 2022
- Let's Build: Music Card Generator May 5, 2022