News for hackers. Stuff that matters.
Re:REST in peace, SOAP by jsdalton on Friday October 15, 2010 @01:36PM (#1795417)
I think you're wrong to dismiss most developers' efforts at a REST API as cargo-culting. A half-ass REST API is better than XML-RPC or SOAP, at least in my humble opinion.

Out of curiosity, though, do you know of any examples of what you consider "true" REST APIs vs. examples of "ad-hoc XML-RPC masquerading as REST" APIs? Maybe I don't have enough experience consuming true REST APIs to be able to fully appreciate their merits.

Re:REST in peace, SOAP by masklinn on Friday October 15, 2010 @02:39PM (#1795670)
> do you know of any examples of what you consider "true" REST APIs

APP is generally considered a pretty RESTful API.

> vs. examples of "ad-hoc XML-RPC masquerading as REST" APIs?

Roy Fielding took a few in his sight on his blog in the past: http://roy.gbiv.com/untangled/tag/rest

Re:REST in peace, SOAP by forensic on Saturday October 16, 2010 @05:13AM (#1797655)
What is APP?
Re:REST in peace, SOAP by masklinn on Saturday October 16, 2010 @05:48AM (#1797677)
the Atom Publishing Protocol (http://en.wikipedia.org/wiki/Atom_Publishing_Protocol also called AtomPub)
Re:REST in peace, SOAP by jmillikin on Friday October 15, 2010 @01:50PM (#1795490)
The prototypical example of a REST API is a web application. They use a standard content type (HTML or XHTML), hypertext to link resources, and typically don't require any out-of-band technical information to work.
Re:REST in peace, SOAP by jsdalton on Friday October 15, 2010 @02:18PM (#1795586)
Right, that makes sense. But I guess I don't really understand how that moves the conversation forward.

Maybe I misread your original comment, but it sounded to me like you were claiming that there are a whole buncha crappy REST APIs out there that are no better than the crappy XML-RPC/SOAP APIs of yore, and that there would be a whole new world of coolness if only they stayed true to the REST protocol.

Saying, "oh, it's just the web," is just another variation of the obscurity in Fielding's post that tptacek is complaining about in his comment.

Anyhow, it's not like you have some responsibility to justify REST to me or anything, but I'm as yet unconvinced of what this gap between "true" and "pretend" REST APIs really is, and what benefits lie for everyone in close that gap.

EDIT: Just saw your "translation" of that Fielding post in reply to tptacek's comment, which was quite helpful.

Re:REST in peace, SOAP by jmillikin on Friday October 15, 2010 @02:31PM (#1795637)
I'm not claiming that XML-RPC or SOAP is "crappy"; there might be poorly-designed implementations (and of REST also!), but both have vital and important use cases. I have never used SOAP, but have both designed and consumed many XML-RPC APIs, and have no problem with them.

It's very important to use accurate terminology when discussing software and technology. The statement "Foo.com uses a REST API" only contains useful information if 'REST' is meaningfully defined. If 'REST' is redefined as a synonym for 'XML-RPC', then we lose the ability to distinguish between a REST and XML-RPC API in written or spoken conversation. I am not making any value judgment regarding either API style; they are simply different, and should be kept distinct for the purposes of communication.