Waiting for engine...
Skip to main content

Downloading API URL Parameters using a 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 the download failed, the server returns server error code in the parameter ThruErrorCode.

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

note

The value of ThruErrorReportingUrl is not validated. You should verify it is a valid URL that exists when building download URL.

  • ThruFiles (optional): String of comma separated IDs of the files to download.

String format:

<fileId1>,… <fileIdN>.

For example: ThruFiles="0F540NC8ZAMQO, 2CNMH8XKUISGU"

  • ThruFolders (optional): String of comma separated IDs of folders for download.

String format:

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

For 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