8.2.3 Download API URL Parameters, option with Session token

• ThruSessionId [mandatory] Session token - unique identifier of the current session. Regular session type is deleted after the next login under the same account credentials. Immutable session type can be created concurrently under the same account credentials an expire after configurable time, default is 48 hours.

• ThruSuccessUrl [mandatory] : Browser will be redirected to this URL on successful download

• ThruErrorReportingUrl [mandatory] : Browser window will be redirected to this URL on failed download.

If download failed, server will return server error code (see below) in parameter “ThruErrorCode”.

If an error occurred and ThruErrorReportingURL is not defined, the server will throw an exception.

Note: the value of ThruErrorReportingUrl is not validated. You should verify it is a valid URL that does exist when building download URL.

• ThruFiles [optional] – string of comma separated IDs of the files to download.

String format:

<fileId1>,… <fileIdN> .

Example: ThruFiles="0F540NC8ZAMQO, 2CNMH8XKUISGU"

• ThruFolders [optional] – string of comma separated IDs of folders for download.

String format:

<fileId1>, <fileId2> … <fileIdN> .

Example: ThruFolders="2CNMH8XKUISGU, 0F540NC8ZAMQO"

Note: at least one parameter ThruFiles or ThruFolders should be present.

Download URL sample:
https://test.thruinc.net/ExternalJavaDownload.aspx?ThruSessionID=CcDqiDeTFjxji+TxnB+sDV0utoSPsZpD0U1yocoTSKBMOAGxLxGQbMulr/cMLJ27FHpZe5R2ks+r6a+yn0A40eMQm70bKrpd1u3HsKSsmCPqGz0e7Aq8Ay211kspoWI8rqbfZ0TzXveslkp1XBm88f8GR/cFhQ+d&ThruFiles=0F540NC8ZAMQO,2CNMH8XKUISGU&ThruFolders=2CNMH8XKUISGU&ThruSuccessUrl= http://server/ExtDownload/success.html&ThruErrorReportingUrl=http://server/ExtDownload/error.html