Merge pull request #1087 from epriestley/batch-upload-download
Properly correct batch upload/download skip detection documentation
This commit is contained in:
commit
8f90f59416
@ -99,16 +99,17 @@ schemas:
|
|||||||
|
|
||||||
Here are the valid actions:
|
Here are the valid actions:
|
||||||
|
|
||||||
* `upload` - This relation describes how to upload the object. Expect this with
|
* `upload` - This relation describes how to upload the object. If the object
|
||||||
when the object has not been previously uploaded.
|
has not previously been uploaded the server should provide this action. If
|
||||||
|
the object has been previously uploaded and the object content is known to the
|
||||||
|
server, it should not provide this action. When the action is not provided,
|
||||||
|
the client should assume the server already knows the object content and skip
|
||||||
|
uploading it.
|
||||||
* `verify` - The server can specify a URL for the client to hit after
|
* `verify` - The server can specify a URL for the client to hit after
|
||||||
successfully uploading an object. This is an optional relation for the case that
|
successfully uploading an object. This is an optional relation for the case that
|
||||||
the server has not verified the object.
|
the server has not verified the object.
|
||||||
* `download` - This relation describes how to download the object content. This
|
* `download` - This relation describes how to download the object content. This
|
||||||
only appears if an object has been previously uploaded. If object content is
|
only appears if an object has been previously uploaded.
|
||||||
already available, the server should provide this action even if the request
|
|
||||||
operation is `upload`, because the client can use the presence of this action to
|
|
||||||
avoid duplicate uploads of object content which is already known to the server.
|
|
||||||
|
|
||||||
An action can optionally include an `expires_at`, which is an ISO 8601 formatted
|
An action can optionally include an `expires_at`, which is an ISO 8601 formatted
|
||||||
timestamp for when the given action expires (usually due to a temporary token).
|
timestamp for when the given action expires (usually due to a temporary token).
|
||||||
|
Loading…
Reference in New Issue
Block a user