Clarification on Functions in `api.js : download?

[Zebulaon]

I noticed some functions in the api.js file—specifically getDownloadUrl, getDownloadToken, and checkDownloadToken. While I understand their general purpose and structure, I would like to get a better understanding of how they work together.

Here are my main questions:

1. How do these functions interact with the rest of the project?
2. Are there specific prerequisites or configurations required to ensure they work as expected?
3. Are there any best practices for using these functions, especially when handling errors?

Thank you very much for your time and for providing this great project. I appreciate any guidance or insights you can offer.

Best regards,

[xob0t]

Hi!

1. They do not. Those methods are just for console scripts.
2. No.
3. In GP, there are (at least) 3 ways to get an item's download url.
   • Get item's media info, downloadUrl is one of its fields.
   • use getDownloadUrl.
     Supports downloading multiple items at once.
     If downloading multiple items, files will be zipped. Multiple file downloads are missing a content length header.
   • use getDownloadToken to get a download token, then wait for download to become available by checking token with checkDownloadToken.
     Supports downloading multiple items at once.
     Files will be zipped regardless, response has a content length header.

[Zebulaon]

Thank you for your response and congratulations again on your excellent project.