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(a)lists.fedorahosted.org
https://fedorahosted.org/mailman/listinfo/aeolus-devel