Haven't looked at the API in question yet.. but after reading the above and the other one about Amazon potentially proving REST unnecessary I think, in the interests of fairness, it's worth clarifying a couple of aspects of REST which seem to be being overlooked.
First off - "doing REST" or "being RESTful" doesn't have much concern with achieving short-run simplicity or making life easier for your clients, that is a miss-conception. In fact, creating a RESTful application for machines (i.e. an "API") is, at this point in time, probably more challenging for both client and server; as there are still some relatively unknown quantities and considerations - specifically in media type design and/or selection. For example; there is no HTML of the machine web. Yet.
Second - What is an explicit objective of RESTful design (particularly hypermedia) is the long-term evolvability of your application/system. This REST stuff isn't esoteric or religious, it is solid theory based on high quality analysis of the most robust distributed system ever produced by a bunch of talking monkeys. If in doubt you could always read the dissertation where the term came from.
RESTafari prophecy holds that the less RESTful applications will struggle to manage change and avoid breaking tightly coupled clients. This will negatively impact the speed and cost of innovation - making them less competitive over time.
In the end, longer-term case studies will do a much better job of illuminating whether or not REST actually delivers on the (business) value it promises, and whether the "simpler" solutions for the short-term continue to be sustainable and cost effective in the long run. Until then, you're probably jumping the gun a bit.
Designing, building and cultivating a system that efficiently evolves over time could present a significant long-term competitive advantage for API providers that get it right. I think that's worth some consideration.
I'll finish with a quote from the great Bob Marley:
"Facts an' facts, an' t'ings an t'ings: dem's all a lotta fockin' bullshit. Hear me! Dere is no truth but de one truth, an' that is the truth of Jah Restafari."
Cheers,
Mike
I've always found a bit of a Catch-22 in releasing a finely-crafted REST API.
ReplyDeleteThat is, by the time you've gotten it all polished and released a shining example of HATEOAS with all your methods and resources and content-types in a row... Twitter's gone and taken the market with an adhoc API that made writing good-enough clients easy.
That's where the "doesn't have much concern with achieving short-run simplicity or making life easier for your clients" part is important. A lot of the change happening out there right now is short-run, or not run at all.
I'm a firm believer in the long-run benefits of REST, and I hope that a lot of the expedient silo-site APIs of today get pushed aside by more general and web-wide REST eventually. But, I'm still bothered by the short term
Hi Leslie, I agree - hopefully new hypermedia frameworks such as restfulie along with generic/extensible media types etc. will help to ease the pain enough that REST can be as appropriate short-term as the alternatives
ReplyDeleteThanks so much with this fantastic new web site. I’m very fired up to show it to anyone. It makes me so satisfied your vast understanding and wisdom have a new channel for trying into the world.
ReplyDelete