The Filewall API is a file processing RESTful API that converts an uploaded file into a secure format by opening it in an encrypted environment, taking screenshots, and converting the screenshots to PDF or another format.
Similar to a fax, this ensures that any malicious content is removed and the end-user receives a clean file.
A typical use case for Filewall is to clean all incoming email attachments to a mail server.
The general workflow is as follows:
Authorizeendpoint to request an upload URL.
Uploadendpoint to upload the file to the upload URL.
Status endpoint to view the file processing status. Options are:
statusis either Waiting or Processing, repeat the call in five seconds.
statusis Finished, a download URL is displayed.
Downloadendpoint to receive the processed file.
The Filewall API requires a valid API key passed in the header of the initial request, as well as when calling the status of a file being processed. To obtain an API key:
Authorizeendpoint. See Authorize for details.
links.uploadfield on the response body.
Uploadendpoint. See Upload for details.
links.selfURL returned in the response body of the successful
links.downloadfield in the response body of the Status endpoint to download the converted file.
If you run into errors when uploading or requesting an upload URL, contact Filewall Support.