]> git.rkrishnan.org Git - tahoe-lafs/tahoe-lafs.git/commit
webapi.txt: overhaul documentation. API changes are as follows:
authorBrian Warner <warner@allmydata.com>
Mon, 19 May 2008 19:47:46 +0000 (12:47 -0700)
committerBrian Warner <warner@allmydata.com>
Mon, 19 May 2008 19:47:46 +0000 (12:47 -0700)
commit151f69d9b59ee76522c5ae3dad259ded752e8ad4
treefef24a65138b3290f5f5fb22753f93ae7f70aab7
parent869e1ed41aa7b36dff3d7a217544cdb289ae7ccb
webapi.txt: overhaul documentation. API changes are as follows:

 * download/upload localdir=/localfile= has been removed. This sort of ambient
   authority was unsafe to expose over the web (CSRF), and at some point
   soon we'll have 'cp -r' in the CLI to replace it.
 * GET save=filename -> GET filename=filename&save=true
 * GET t=download removed
 * side-effect causing operations now use POST where appropriate, not PUT
 * to create multiple directories, either use
   * POST /uri/DIRCAP/parent?t=mkdir&name=child  (more form/browser oriented)
   * POST /uri/DIRCAP/parent/child?t=mkdir (more machine oriented)
   The t=mkdir-p form is still accepted, but not preferred (since it leaks
   the child name queryarg into the logs)
 * use PUT /uri/MUTABLEFILECAP or PUT /uri/DIRCAP/child (on a mutable file) to
   replace its contents, or POST /same?t=upload from forms
 * response bodies and codes are better specified than before
docs/webapi.txt