== RESTful API ==

This page hosts detailed specifications for [https://blueprints.launchpad.net/sahana3/+spec/rest Blueprint for the RESTful API].

Basic approach for the S3 architecture is to have a Web Services backend & a Javascript client front end.

RESTful APIs make this easier.

Web2Py generates fairly RESTful URLs anyway for the user-facing HTML pages, such as /sahana/pr/display_person/4

We can extend this for exporting raw data in other formats using the optional vars: /sahana/pr/display_person/4?[xml|csv]

This, obviously, requires us to build-in support into the Controllers, which should be done within the framework to make it easy for module writers to take advantage of.

Web2Py already supports export as JSON, CSV & RTF. Hope to extend this to XML using http://www.reportlab.org/pyrxp.html
 * SQLRow to JSON: http://groups.google.com/group/web2py/browse_thread/thread/dfb65087574c24f1

Web2Py currently doesn't support HTTP PUT/DELETE/UPDATE (only GET).