Skip to content

Read File

David Haller edited this page Jul 9, 2018 · 6 revisions

Download file

URL : /files/:id?thumbnail=true|false

Method : GET

Auth required : NO

Set thumbnail=true to get a thumbnail of the file.

Warning: This method works without client authentication. An attacker could download files by just guessing file ids. This must be changed for production use, unfortunately using HTTP Basic Auth for file download does not work yet in the web/mobile clients, so auth has been disabled for demo purposes.

Success Response

307 TEMPORARY REDIRECT

The Location-header in the response indicates where the file can be found.

Error Response

400 BAD CONTENT

Thumbnail was requested, but file does not support thumbnails.

401 UNAUTHORIZED

Authorization fails.

403 FORBIDDEN

The permissions are not sufficient.

404 NOT FOUND

File does not exist.

501 NOT IMPLEMENTED

The backend has no file storage configured.