`autolist`

This command is used to list all the data stored about every drop-off that is currently on your ZendTo site, and outputs it as a JSON structure. The data includes

claimID & passcode
sender details
creation & expiry dates, both human-readable and system times
size, both human-readable and number of bytes
note, encryption status & number of pick-ups
name & email of each recipient
name, size, type, description, checksum & fileID of each file

Your ZendTo server will have the "jq" package installed. This is a tiny package containing the "jq" command, which can filter and format JSON structures. Piping the output of autolist through jq will make it print it nicely formatted and laid out. To do this, just add "| jq" onto the very end of the example commands.

For the example commands, let's define a few things which you will change for your own use:

The automation user is going to have the username "robot" with a password of "machines"
The address of your ZendTo site will be "https://your-zendto-site.com/". The site address always goes at the very end of the command, after all the other options.

Troubleshooting Options

If you are using a locally-signed SSL certificate on your ZendTo server, you may need to add the option
--insecure
to all of the example commands. The option tells curl to skip all the validity checks on the SSL certificate on your ZendTo server.

To see the curl command it creates, which is what does all the work, but not actually run anything, add the option
--debug
to any of the example commands. This is extremely useful if you are looking to re-implement the functionality of the script in another environment.

Examples

To see the command-line usage: /opt/zendto/bin/autolist --help
Fetch all the data stored about every drop-off: /opt/zendto/bin/autolist --username 'robot' --password 'machines' https://your-zendto-site.com/
As above, but formatted in a human-readable layout: /opt/zendto/bin/autolist --username 'robot' --password 'machines' https://your-zendto-site.com/ | jq