<?xml version="1.0" encoding="UTF-8"?><!-- generator="wordpress/2.2" -->
<rss version="2.0" 
	xmlns:content="http://purl.org/rss/1.0/modules/content/">
<channel>
	<title>Comments on: Please Phil - do the right thing - and KISS</title>
	<link>http://blog.broadbandmechanics.com/2006/05/please-phil-do-the-right-thing-and-kiss</link>
	<description>Digital Lifestyle Aggregation - helping to establish open source infrastructure</description>
	<pubDate>Fri, 04 Jul 2008 20:14:08 +0000</pubDate>
	<generator>http://wordpress.org/?v=2.2</generator>

	<item>
		<title>By: Phillip Pearson</title>
		<link>http://blog.broadbandmechanics.com/2006/05/please-phil-do-the-right-thing-and-kiss#comment-40874</link>
		<author>Phillip Pearson</author>
		<pubDate>Sun, 21 May 2006 18:56:09 +0000</pubDate>
		<guid>http://blog.broadbandmechanics.com/2006/05/please-phil-do-the-right-thing-and-kiss#comment-40874</guid>
		<description>Can you forward some of this feedback to me?

The plan at the moment is to continue with what we've got, which is:

- everything accessible by xml-rpc

- or also through a more 'rest' like interface, using GET and POST, with input url-encoded (so you can test in a browser) and output encoded in XML or JSON (the user gets to choose).

The usage recommendation would be:

- for general users, use xml-rpc unless you are particularly keen on xml, in which case use the REST interface with XML output.

- for laszlo/flash callers, use the REST/XML version.

- for ajax code running inside peepagg, use the REST/JSON version.

The big question in my mind is: should we make the xml version's output look exactly like output from the flickr api, or should we make it consistent with the xml-rpc and json versions?

Flickr's output looks like this (angle-brackets changed to normal brackets):

(rsp stat="ok")
    [content here]
(/rsp)

whereas at the moment we have:

(response)
    (success)true(/success)
    [content here]
(/response)

I'm going to go look at flickr's xml-rpc output now to see how it's been done there - as they offer an XML-RPC interface as well.</description>
		<content:encoded><![CDATA[<p>Can you forward some of this feedback to me?</p>
<p>The plan at the moment is to continue with what we&#8217;ve got, which is:</p>
<p>- everything accessible by xml-rpc</p>
<p>- or also through a more &#8216;rest&#8217; like interface, using GET and POST, with input url-encoded (so you can test in a browser) and output encoded in XML or JSON (the user gets to choose).</p>
<p>The usage recommendation would be:</p>
<p>- for general users, use xml-rpc unless you are particularly keen on xml, in which case use the REST interface with XML output.</p>
<p>- for laszlo/flash callers, use the REST/XML version.</p>
<p>- for ajax code running inside peepagg, use the REST/JSON version.</p>
<p>The big question in my mind is: should we make the xml version&#8217;s output look exactly like output from the flickr api, or should we make it consistent with the xml-rpc and json versions?</p>
<p>Flickr&#8217;s output looks like this (angle-brackets changed to normal brackets):</p>
<p>(rsp stat=&#8221;ok&#8221;)<br />
    [content here]<br />
(/rsp)</p>
<p>whereas at the moment we have:</p>
<p>(response)<br />
    (success)true(/success)<br />
    [content here]<br />
(/response)</p>
<p>I&#8217;m going to go look at flickr&#8217;s xml-rpc output now to see how it&#8217;s been done there - as they offer an XML-RPC interface as well.</p>
]]></content:encoded>
	</item>
</channel>
</rss>
