RESTAPI:Revoking a Transfer: Unterschied zwischen den Versionen

Aus Cryptshare Documentation
Wechseln zu:Navigation, Suche
(Die Seite wurde neu angelegt: „{{InfoBox|title=|content=Please note that the Cryptshare Server only allows this operation for verified sender addresses or verified email addresses (see [[{{NAMESPACE}}:About_Verifications|Verification]]). }} With this endpoint, a sender of a sent transfer is able to make this transfer inaccessible anymore. After performing the revocation, the transfer files will be deleted from the Cryptshare server and cannot be downloaded anymore. By default, the sen…“)
 
Keine Bearbeitungszusammenfassung
Zeile 3: Zeile 3:


With this endpoint, a sender of a sent transfer is able to make this transfer inaccessible anymore. After performing the revocation, the transfer files will be deleted from the Cryptshare server and cannot be downloaded anymore. By default, the sender and the recipient will receive a pre-configured revocation notifications that the transfer is now not accessible anymore.
With this endpoint, a sender of a sent transfer is able to make this transfer inaccessible anymore. After performing the revocation, the transfer files will be deleted from the Cryptshare server and cannot be downloaded anymore. By default, the sender and the recipient will receive a pre-configured revocation notifications that the transfer is now not accessible anymore.
Revocation is only available for the sender of a specific transfer. This means, one sender cannot revoke a transfer from another sender.


Reasons for the need of revocations might be
Reasons for the need of revocations might be
Zeile 13: Zeile 11:
More general information regarding the revocation of transfers can be found in the [[CSSCurrent_en:Revoke_Transfer|Cryptshare Server documentation]].
More general information regarding the revocation of transfers can be found in the [[CSSCurrent_en:Revoke_Transfer|Cryptshare Server documentation]].


PATCH https://<your-url>/api/users/<sender email-address>/transfers/<tracking-id>
Revocation is only available for the sender of a specific transfer. This means, one sender cannot revoke a transfer from another sender.


Only transfers that are available for recipients can be revoked (Transfer Status: Active). Already expired transfers cannot be revoked.




The language for the sender and recipient revocation notification can be configured by defining a locale via the '''Accept-Language''' header for this request.
'''PATCH''' https://<your-url>/api/users/<sender email-address>/transfers/<tracking-id>
{| class="wikitable"
|+The request body
!Field name
!Type
|-
|status
|TransferRevocationStatus (required)
|-
|revocationOptions
|TransferRevocationOptions
|}
{| class="wikitable"
|+The TransferRevocationStatus object
!Field name
!Value
!Remarks
|-
|state
|DELETED_BY_REVOCATION
|required
|}
{| class="wikitable"
|+The TransferRevocationOptions object
!Field name
!Value Type
!Remarks
!Default value
|-
|notifySender
|boolean
|optional
|true
|-
|notifyRecipients
|boolean
|optional
|true
|-
|message
|markdown string
|optional
|set via installed language pack and language from Accept-Language header
|}
The language for the default sender and recipient revocation notification can be configured by defining a locale via the '''Accept-Language''' header for this request.

Version vom 10. Juni 2024, 08:16 Uhr

Please note that the Cryptshare Server only allows this operation for verified sender addresses or verified email addresses (see Verification).

With this endpoint, a sender of a sent transfer is able to make this transfer inaccessible anymore. After performing the revocation, the transfer files will be deleted from the Cryptshare server and cannot be downloaded anymore. By default, the sender and the recipient will receive a pre-configured revocation notifications that the transfer is now not accessible anymore.

Reasons for the need of revocations might be

  • The transfer contains outdated information and was obsoleted by a new transfer.
  • The sender chose the wrong recipient(s) for this transfer.
  • Due to security or regulatory reasons, e.g. immediately after a transfer was downloaded.

More general information regarding the revocation of transfers can be found in the Cryptshare Server documentation.

Revocation is only available for the sender of a specific transfer. This means, one sender cannot revoke a transfer from another sender.

Only transfers that are available for recipients can be revoked (Transfer Status: Active). Already expired transfers cannot be revoked.


PATCH https://<your-url>/api/users/<sender email-address>/transfers/<tracking-id>

The request body
Field name Type
status TransferRevocationStatus (required)
revocationOptions TransferRevocationOptions
The TransferRevocationStatus object
Field name Value Remarks
state DELETED_BY_REVOCATION required
The TransferRevocationOptions object
Field name Value Type Remarks Default value
notifySender boolean optional true
notifyRecipients boolean optional true
message markdown string optional set via installed language pack and language from Accept-Language header

The language for the default sender and recipient revocation notification can be configured by defining a locale via the Accept-Language header for this request.