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