ExternalVendorCode/tahoe-lafs
1
0
Fork 0
mirror of https://github.com/tahoe-lafs/tahoe-lafs.git synced 2024-12-23 23:02:25 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

docs/webapi.rst: address Kevan's comments about use of 'delete' on ref #1104

Browse Source
This commit is contained in:
david-sarah 2011-08-01 13:53:56 -07:00
parent 4861d50c2f
commit 00dccc4377
1 changed files with 6 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
docs/frontends/webapi.rst
View File

@ -88,9 +88,10 @@ URL) will return information about the object, such as metadata. GET
operations are required to have no side-effects. operations are required to have no side-effects.
PUT is used to upload new objects into the filesystem, or to replace an PUT is used to upload new objects into the filesystem, or to replace an
existing object. DELETE is used to delete objects from the filesystem. Both existing link or the contents of a mutable file. DELETE is used to unlink
PUT and DELETE are required to be idempotent: performing the same operation objects from directories. Both PUT and DELETE are required to be idempotent:
multiple times must have the same side-effects as only performing it once. performing the same operation multiple times must have the same side-effects
as only performing it once.
POST is used for more complicated actions that cannot be expressed as a GET, POST is used for more complicated actions that cannot be expressed as a GET,
PUT, or DELETE. POST operations can be thought of as a method call: sending PUT, or DELETE. POST operations can be thought of as a method call: sending
@ -935,8 +936,8 @@ Viewing A Directory (as HTML)
browser, which contains HREF links to all files and directories reachable browser, which contains HREF links to all files and directories reachable
from this directory. These HREF links do not have a t= argument, meaning from this directory. These HREF links do not have a t= argument, meaning
that a human who follows them will get pages also meant for a human. It also that a human who follows them will get pages also meant for a human. It also
contains forms to upload new files, and to delete files and directories. contains forms to upload new files, and to unlink files and directories
Those forms use POST methods to do their job. from their parent directory. Those forms use POST methods to do their job.
Viewing/Downloading a File Viewing/Downloading a File
-------------------------- --------------------------