Download A File
This API call allows you to download the files stored in MetaDefender Vault.
The call should be made to vault_rest/file/{file_id} through a GET request. Please note that you need to obtain {file_id} in order to retrieve the file.
Title |
Download a file |
URL Path |
vault_rest/file/{file_id} |
Method |
GET |
HTTP return codes |
200, 400, 401, 403, 404, 500 |
Table of Contents |
|
Last Updated |
08 Oct 2019 |
HTTP header parameters
Name |
Value |
Required |
Description |
Example |
Authorization |
The API key of the caller |
REQUIRED |
This header should have the following format: |
GET /vault_rest/file/296fb5f15041430fa9cbc96710d3b21d HTTP/1.1 Host: localhost:8010 Authorization: Bearer OrRnBd9J0AzTiUe4Xrevj6IUoHbdMs skip_notify: 0 |
Method: GET
file_id |
Id of the file you wish to download |
REQUIRED |
Request Error
400 |
Bad Request |
Invalid HTTP request |
401 |
Invalid parameter |
One or more parameters are invalid |
403 |
Forbidden |
Authentication credentials incorrect |
404 |
Not found |
File was not found in the database |
500 |
Internal Server Error |
Server is temporarily unavailable |
Example of a successful scan request
[Content Stream] |
Descriptions of response
The complete content stream of the file.
Notification
Just as regular downloads via the Web UI, downloads initiated via REST will generate email notifications based on the settings defined in "Default Transfer Settings" (see below).
Example of email notification
Hi
[%]InitialSenderName[%],
The following
transfer has been successfully downloaded:
Date:
[%]DateAndTime[%]
Subject:
[%]TransferSubject[%]
File:
[%]FileName[%]
[%]Signature[%]