---------- Forwarded message ---------- From: "Geert Jansen" gjansen@redhat.com Date: Aug 3, 2011 7:11 PM Subject: [rest-practices] Piece on RESTful API Design To: "rhevm-api" rhevm-api@lists.fedorahosted.org, < aeolus-devel@fedorahosted.org>, rest-practices@redhat.com

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/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

______________________________**_________________ rest-practices mailing list rest-practices@redhat.com https://www.redhat.com/**mailman/listinfo/rest-**practiceshttps://www.redhat.com/mailman/listinfo/rest-practices