What We Need is More REST and Less ROT

Programming
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 speaker, Mike Amundsen travels the world discussing network architecture, Web development, and the intersection of technology and society. He works with companies large and small to help them capitalize on the opportunities provided by APIs, Microservices, and Digital Transformation.

Amundsen has authored numerous books and papers. He contributed to the O’Reilly book, “Continuous API Management” (2018). His “RESTful Web Clients”, was published by O’Reilly in February 2017 and he co-authored “Microservice Architecture” (June 2016). His latest book — “Design and Build Great APIs” — for Pragmatic Publishing is scheduled for release in late 2019.

Comments on this page are now closed.

Comments

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

Elliot:

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.