@@ -763,8 +763,10 @@ To create a Share, the Sending Server SHOULD make a HTTP POST request
763763 by the Receiving Server.
764764* OPTIONAL expiration (integer)
765765 The expiration time for the OCM share, in seconds
766- of UTC time since Unix epoch. If omitted, it is assumed
767- that the share does not expire.
766+ of UTC time since Unix epoch. If omitted, it is assumed that the
767+ share does not expire. A sender server MAY use it to signal that
768+ the resource represents a cached copy of a dataset that was made
769+ available for an efficient data transfer to the destination server.
768770* REQUIRED protocol (object)
769771 JSON object with specific options for each protocol.
770772 The supported protocols are : - `webdav`, to access the data -
@@ -801,9 +803,13 @@ To create a Share, the Sending Server SHOULD make a HTTP POST request
801803 being granted to the remote resource. If omitted, it defaults to
802804 `['remote']`. A subset of : - `remote` signals the recipient that
803805 the resource is available for remote access and interactive
804- browsing. - `datatx` signals the recipient to transfer the
805- resource from the given URI. The recipient MAY delegate a
806- third-party service to execute the data transfer on their behalf.
806+ browsing. - `datatx` signals the recipient that the resource is
807+ available for data transfer. If no expiration is given, the share
808+ is suitable e.g. for sync use-cases, whereas if an expiration date
809+ is set, the above clause MAY apply and the recipient SHOULD notify
810+ the sender upon completing the data transfer, in order to ease
811+ cache operations on the Sending Server. The recipient MAY delegate
812+ a third-party service to execute the data transfer on their behalf.
807813 - REQUIRED uri (string)
808814 A URI to access the Remote Resource. The URI
809815 SHOULD be relative, in which case the prefix
0 commit comments