[rest-practices] Piece on RESTful API Design

Mark Little mlittle at redhat.com
Tue Aug 9 12:06:03 UTC 2011


I like it. We should try and link it into the REST-* web site too.

Bill, what do you think?

Mark.


On 4 Aug 2011, at 00:10, 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
> 
> _______________________________________________
> rest-practices mailing list
> rest-practices at redhat.com
> https://www.redhat.com/mailman/listinfo/rest-practices

---
Mark Little
mlittle at redhat.com

JBoss, by Red Hat
Registered Address: Red Hat UK Ltd, Amberley Place, 107-111 Peascod Street, Windsor, Berkshire, SI4 1TE, United Kingdom.
Registered in UK and Wales under Company Registration No. 3798903 Directors: Michael Cunningham (USA), Charlie Peters (USA), Matt Parsons (USA) and Brendan Lane (Ireland).








More information about the rest-practices mailing list