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:
Authorize
endpoint to request an upload URL.
Upload
endpoint to upload the file to the upload URL.
Call the Status
endpoint to view the file processing status. Options are:
status
is either Waiting or Processing, repeat the call in five seconds.
status
is Finished, a download URL is displayed.
Download
endpoint 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:
Authorize
endpoint. See Authorize for details.links.upload
field on the response body.Upload
endpoint. See Upload for details.links.self
URL returned in the response body of the successful Authorize
request.links.download
field 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.