| Parameters | Description | Example | Format | Required |
|---|---|---|---|---|
| key | API-Key | 1ltghrilhllgrx2b2 | STRING | yes |
| url | Remote url | https://examples.com/file.zip | STRING | yes |
| folder | Folder to put the file in (default: your root folder) | 58 | Number | no |
curl --include \
'https://send.now/api/upload/url?key=1ltghrilhllgrx2b2&url=https://file-examples.com/file.zip'
{
"result": {
"file_code": "0rw8u8exqqte",
"filecode": "0rw8u8exqqte"
},
"server_time": "2024-08-01 18:15:42",
"msg": "OK",
"status": 200
}
{
"status": 200,
"msg": "OK",
"result": {
"file_code": "0rw8u8exqqte",
"status": "WORKING",
"progress_percent": 42,
"size_dl": 4404019,
"size_full": 10485760
},
"server_time": "2024-08-01 18:15:50"
}
When the download is finished the reply is "msg": "Upload completed successfully" and result has "status": "COMPLETED", the name, the size and download_url. Add &remove=1 to cancel a download that is still queued.
| The server downloads the url in the background; the reply only confirms it was queued. Use the file code to follow it. | |
| Only public http(s) addresses are accepted. Addresses inside a network (localhost, private and link-local IP addresses, internal host names) are refused with 400 "URL not allowed". | |
| An API key is required: remote upload is not available to anonymous visitors. |
| 200 | Everything is OK. Request succeeded |
| 400 | Bad request (e.g. wrong parameters) |
| 403 | Permission denied |
| 404 | File not found |
| 451 | Unavailable |