AddThis Blog

Keeping It Simple with URL Design for RESTful Web Services

The following is a guest post by AddThis VP of Engineering, Charlie Reverte, posted today at APIUX.com. To read the rest of the blog post, click here to go over to their site.

URL design discussions for RESTful web services often degrade into debates over pluralization and parameter names. There are a couple of principles I like to use to keep things simple.

1) Using your API should feel like using a filesystem

2) All calls to a given endpoint should return the same type

We may be bikeshedding here but I think your API will be more intuitive to newcomers if you model it this way.

To read the rest of this blog post, head over to APIUX.