If it were appropriate I'd hump your leg. Please, everyone, even if you don't feel the need to build an api that honours the intent of REST, at least read this and understand what one looks like. 99% of so-called REST APIs are really just HTTP APIs (which is sad as REST has very little to do with HTTP). Single point of entry, linking via opaque links, and media-types - 3 of the most fundamental aspects of REST and yet 3 of the most ignored. Yes I'm looking at you Ruby on Rails.
Nice work.
On 04/08/2011, at 9:10 AM, Geert Jansen wrote:
Hi,
i wanted to do this for a long time, and finally got it it. See the link below for an essay on RESTful API design, based on lessons learnt from rhevm-api project:
http://readthedocs.org/docs/restful-api-design/en/latest/
From the intro: "This is essay is an attempt to put down my thoughts on how to design a real-world yet beautiful RESTful API." It goes into such topics as JSON vs XML, why not XMLSchema, creating CLIs, and more.
Mark, it also contains a worked out version of your idea to use forms for describing inputs.
Feedback is welcome!
Regards, Geert _______________________________________________ aeolus-devel mailing list aeolus-devel@lists.fedorahosted.org https://fedorahosted.org/mailman/listinfo/aeolus-devel