Sender-recipient Transfer Polling
The Sender/Recipient Transfer Polling endpoints allows API consumers to list all transfers the verified sender or recipient email address has sent.
Request all transfers of a given sender[Bearbeiten | Quelltext bearbeiten]
Sender GET https://<your-url>/api/users/<sender email-address>/transfers/sent-transfers
Recipient GET https://<your-url>/api/users/<sender email-address>/transfers/received-transfers
Due to a possible large number of transfers, pagination is used for this endpoint.
Farther filtering parameters also available.
Parameter name | Default value | Remarks |
---|---|---|
page | 1 | Page numbers are 1-indexed. |
page-size | 10 | The maximum value for the page-size is 100. |
active | active and inactive | To filter the result of the returned transfers set as the following:
(active=true) : only active transfers set will be returned. (active=false) : only inactive transfers set will be returned. without sending or setting the value of this parameter the result transfers set will contain both the active and the inactive transfers |
fields | trackingId, status(recipients), transfer(recipients) | The parameter is used to select a specific objects of the result transfers set.
The "," is used to separate between different selected objects names. To select a nested objects inside one of the main once, use the brackets () and again the "," in between the nested objects inside the selected one, e.g. status(recipients, state) Note that you can select multiple objects over multiple nested objects levels, e.g. status(state), transfer(recipients(to, cc), expirationDate, securityMode(config(passwordMode))) |
The default returned information contains a basic set of information for the transfer(s). Detailed information per transfer can be retrieved using the Transfer Status endpoint..
Description | Property |
---|---|
The transfer identifier. | trackingId |
The Recipients object of the transfer | status(recipients) |
A set of recipient objects with mail and their individual transfer-id. | transfer(recipients) |
By adding the field Status(state) to your fields parameter, you may obtain the state value for each transfer, witch can be on of the following:
State name | Description |
---|---|
Active | The transfer is available to be downloaded by the recipients. |
Deleted_by_expiration | The transfer is not available anymore, due to reaching the expiration date. |
Deleted_by_revocation | The transfer is not available anymore, due to revocation by the sender. |
Deleted_by_admin | The transfer is not available anymore, due to deletion by the Cryptshare server administrator via the Transfer Log. |
Deleted_by_security | The transfer is not available anymore, due to too many failed download attempts by recipients. |
Processing | The transfer is not available yet. The finalization of this transfer-session was triggered, but is not finished yet. |
Failed | The transfer is not available, due all files have been removed during finalization. |
Unknown | Transfers that were sent with Cryptshare version 5.7.0 and older have this state. |
Remarks[Bearbeiten | Quelltext bearbeiten]
Depending on the Cryptshare Server setting it might be that not all sent/recipient transfers are available due to the Automated Deletion of Expired Log Entries. This means, all transfers that expired before the configured amount of days will not be returned by this endpoint.
Cryptshare offers the possibility for users to request a deletion of their user data. After the deletion of their data, their email address is replaced by a proxy email address. Therefore, the set of recipients of a transfer might change after a deletion.
Please use the Sender polling endpoint instead:
GET https://<your-url>/api/users/<sender email-address>/transfers/sent-transfersThe Sender Transfer Polling endpoint allows API consumers to list all transfers the verified sender email address has sent.
Request all transfers of a given sender
GET https://<your-url>/api/users/<sender email-address>/transfers
Due to a possible large number of transfers, pagination is used for this endpoint.
Parameter name | Default value | Remarks |
---|---|---|
page | 1 | Page numbers are 1-indexed. |
page-size | 10 | The maximum value for the page-size is 100. |
The returned information contains a basic set of information for the transfers. Detailed information per transfer can be retrieved using the Transfer Status endpoint.
Description | Property |
---|---|
The transfer identifier. | trackingId |
The current state of the transfer (see table below) | state |
A set of recipient objects with mail and their individual transfer-id. | recipients |
The URL for this transfer to access the Transfer Status endpoint | href |