This file service only serves files. Files already have to exist using the same system as the file-service. This service is only for retreiving those files by their share://
instead of their proper virtual file UUID.
SHARE_FOLDER
: this is the path to the folder with the files to serve. This can also be the folder of the file service. (default:/share/
)FILES_GRAPH
: graph where the file metadata is stored. This has to match with the file services graph, or the one used by the service storing the metadata. (default:http://mu.semte.ch/files/
).
This follows the API of the file-service closely, but only for the getting of file metadata and downloading the file.
Get metadata of the file with the given physical file uri
Response 200 OK
Returns the metadata of the file with the given uri.
Response 404 Bad Request
If a file with the given uri cannot be found.
Download the content of the file with the given id.
Query paramaters
name
(optional): name for the downloaded file (e.g./files/1/download?name=report.pdf
)
Response 200 Ok
Expected response, the file is returned.
Response 404 Bad Request
No file could be found with the given uri (on disk).
Response 500 Server error
This error will never be thrown, because no database lookup is necessary.