On 28 Feb 2010, at 00:30, Ross Gardler wrote:
In my opinion the REST API needs to be improved, as it stands it is not very RESTful. A RESTful API uses the HTTP methods as follows:POST is used to create a resource on the server GET is used to retrieve a resource PUT is used to change the state of a resource or to update it DELETE is used to remove or delete a resourceThere are currently many places where these methods are used incorrectly and thus confusingly.Before heading off down the route of redefining the REST API I'd like to understand if it is used or not.My suspicion is that it is not used a great deal (indeed in trying to use it this last few days I have found that parts of it just don't work). Examining the Moodle plugin the REST API is not used at all (there are todo items all over it to change the code to use the REST API).Can we consider rebuilding it now before people start to adopt it? Should we instead adopt a deprecate and replace approach?
I'm also not clear whether what you are suggesting is a change to the API specification:
http://incubator.apache.org/wookie/wookie-rest-api.html Or to its implementation?If the former then the first step should be documenting the proposed spec before rewriting any code.
If the latter I suggest starting with the test cases. These cover the methods concerned and currently these all pass so we need to see have cases that identify broken behaviour.
Ross
smime.p7s
Description: S/MIME cryptographic signature
