Wednesday, August 3, 2011

RESTful API Design

I finally managed to take some time and write out my thoughts on how to design a powerful yet beautiful RESTful API. Read my essay on readthedocs here:

http://restful-api-design.readthedocs.org/en/latest/index.html

2 comments:

Anonymous said...

One of most insightful, thought provoking and best-researched articles I've read about REST in a long time! Thanks for sharing!

ザイツェヴ said...

- Long polling is not that great with NAT either.
- Anything "self-describing" only works with the human in the loop.

And the focus on having "uncoupled" servers and clients seems to be too heavy.