What We Need is More REST and Less ROT

Location: Portland 255
Average rating: ***..
(3.33, 15 ratings)

One of the key properties of RESTful Web applications is the ability to evolve over time. Too many Web APIs don’t evolve; they just get old, and useless; they rot. Why? Because they are little more than URI-based RPC calls returning serialized objects. Instead, Web APIs should rely on well-crafted media-type messages driven by links; they should be more RESTful.

This talk covers a handful of key design decisions that must be faced for every Web 2.0 API implementation. The choices are easy, the work is not. Too many frameworks and programming tools lead developers down the “wrong path” toward short-term expediency using record-based CRUD APIs returing XML or JSON without hyperlinks in the message; they follow the ROT
(Representation Object Transfer) principles. Instead developers and architects need to ignore the “blandishments” of slick editors and frameworks and just knuckle down some hard slogging down the “right path;” the one that leads to a stable, scalable, re-usable, and evolve-able API based on Fielding’s REST principles.

Whether you are an individual developer, a small start-up, or a large, established company, now is the time to start creating more REST and less ROT.

Photo of Mike Amundsen

Mike Amundsen

Amundsen.com, Inc.

An internationally known author and lecturer, Mike Amundsen travels the world consulting and speaking on a wide range of topics, including distributed network architecture, web application development, and other subjects. Mike is the director of architecture for the API Academy, where he heads up the API architecture and design practice in North America and is responsible for working with companies to provide insight on how to best capitalize on the myriad opportunities APIs present to both consumers and the enterprises themselves. Mike has authored numerous books and papers on programming over the last 15 years, including RESTful Web APIs, a collaboration with Leonard Richardson, and Building Hypermedia APIs with HTML5 and Node, an oft-cited reference on building adaptable web applications. His most recent book, RESTful Web Clients, was released in early 2017 by O’Reilly.

Comments on this page are now closed.


Picture of Mike Amundsen
Mike Amundsen
07/28/2011 1:56am PDT


Thanks for the feedback on the talk. I encourage you to check out the HTTP-REST-OSCON-BoF list (groups.google.com/forum/#!forum/http-rest-oscon-bof) and REST-Discuss (tech.groups.yahoo.com/group...) where you can follow up with questions and comments, too.

Elliot Shank
07/28/2011 1:40am PDT

This was really, really good. It changed what I think web service interfaces should be. The action URL idea is brilliant.