Documentation for archiver

[kulmann]

For implementing the download as archive in ownCloud Web I'd like to see some basic documentation. Especially helpful: example requests for

• downloading folder /test from the user home of einstein
• downloading folder /test from the password protected public link GFZpdiHgFOonejL with password asdf

[kulmann]

cc @ishank011 @gmgigi96

[kulmann]

Since the API only accepts a dir and a list of file names, I'm especially unsure how to proceed with public links. I would have expected that the provided path is relative to the authenticated user's home directory. That doesn't seem to be the case.

[gmgigi96]

The archiver does not support yet a password protected public link download.
Instead, to download a normal file/folder, the dir parameter should have as prefix /home, so according to your example dir=/home and file=test.

[kulmann]

Just to get this straight, in your CERN-Box environment you'd have / as dir, so that we need to provide configuration for the path prefix, right?

[kulmann]

In order to get this going for public links as well I'm discussing with @wkloucek right now that this should be implemented using resource ids, not paths.

[kulmann]

Ideas for improvement tracked in #2097 - closing here.