[rest-practices] Piece on RESTful API Design
Geert Jansen
gjansen at redhat.com
Wed Aug 3 23:10:59 UTC 2011
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
More information about the rest-practices
mailing list