Joe Gregorio lays out a simple process for designing a REST application. I’ve been doing a lot of this kind of design and development lately, but I still found that this piece clarified my thinking. In a nutshell, Joe’s process is:

To build a good REST service you need to answer the following questions:

  1. What are the URIs?
  1. What’s the format?
  2. What methods are supported at each URI?
  3. What status codes could be returned?

I like the simple table with columns for Resource, Method, Representation, Status Codes - useful for a initial specification, and I’ve learned about how GET methods should be idempotent.

Thanks to Matt Mower for blogging this link

This was previously published at and was retrieved from the Internet Archive.