CSSCurrent en:Pre defining recipients in the URL

Aus Cryptshare Documentation
Version vom 2. Februar 2023, 08:03 Uhr von imported>Frorathm
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu:Navigation, Suche



Usage

A number of URL query parameters can be used to pre-define certain elements of a new transfer. These query parameters are used for the "`/upload`" URL path of your Cryptshare Server URL, e.g: "`https://my.cryptshare.server/upload?to=john.doe%40cryptshare.com`". Note that all query parameter values need to be URI encoded.

The URL for pre-defining of recipients has changed with Cryptshare 4.10.0.

Old: `https://my.cryptshare.server/Upload1?to=john.doe%40cryptshare.com` `New:` `https://my.cryptshare.server/upload?to=john.doe%40cryptshare.com`

The old URL is still working, but will be removed with future release.
Hint for URL creation
Please note, that there should be no digits directly behind the query parameter character ?.

Wrong: https://my.cryptshare.server/upload?3&to=john.doe%40cryptshare.com

Correct: https://my.cryptshare.server/upload?to=john.doe%40cryptshare.com

Supported URL query parameters

Parameter Name Description Note
`from` Sender of transfer Can only be specified once. If the sender has not yet been verified, it will be redirected to the verification page.
`to` List of "To" recipients for the transfer. Can be specified multiple times in order to add multiple recipients.
`cc` List of "Cc" recipients for the transfer.
`bcc` List of "Bcc" recipients for the transfer.
`notificationSubject` Subject of the recipient notification If the Policy does not allow usage of a custom notification subject, this parameter will be ignored.

Examples

Example 1

If we want to pre-define the "To" value with the email addresses "john.doe@cryptshare.com" and "jane.doe@cryptshare.com":

https://my.cryptshare.server/upload?to=john.doe%40cryptshare.com&to=jane.doe%40cryptshare.com

Example 2

If we want to pre-define the "To" value with the email address "john.doe@cryptshare.com", the "Bcc" value to "jane.doe@cryptshare.com" as well as the subject "Lorem + ipsum!":

https://my.cryptshare.server/upload?to=john.doe%40cryptshare.com&bcc=jane.doe%40cryptshare.com&notificationSubject=Lorem%20%2B%20ipsum!

Example 3

If we want to pre-define the sender mail address to  "john.doe@cryptshare.com", the "To" value with the mail address "jane.doe@cryptshare.com", as well as the subject "Lorem + ipsum!":

`https://my.cryptshare.server/upload?from=john.doe%40cryptshare.com&to=jane.doe%40cryptshare.com&notificationSubject=Lorem%20%2B%20ipsum!`