To REST or not to REST

Mon, 20 Jul 2009 08:41:51 +0000

Yesterday @esjewett pointed out that tarpipe’s API 2.0 might not be considered RESTful. Quoting the previously written article “A RESTful ESME API”:

REST is often seen as an alternative to RPC APIs, or “Remote Procedure Call” APIs. At root, the difference as described by Wikipedia is that RPC is about telling an application to do something while REST is about changing the state of the resources of an application.

Paul Sadauskas, on another article about the same subject, adds some rules that your API should not follow:

Clients have to read documentation to know the locations of top-level resources.

Clients have to concatenate strings to get to the next resource.

You have an “API/Key/Token” in a header or a url.

You have a version string in a url.

All this made me think about possible changes to become RESTful. Things seem to be easy when you’re offering operations to resources you own or control. When you’re dealing with processes that’s a whole different story. As @esjewett best puts it:

Key on Bruno Pedro

To REST or not to REST