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

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