<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Aehso's Output &#187; api</title>
	<atom:link href="http://www.xlml.com/aehso/category/api/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.xlml.com/aehso</link>
	<description>John O'Shea's musings, observations and opinions on anything and everything.</description>
	<lastBuildDate>Mon, 25 Jan 2010 13:31:40 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.9.1</generator>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
			<item>
		<title>Microsoft dropping Web3S for AtomPub for Windows Live! service APIs.</title>
		<link>http://www.xlml.com/aehso/2008/02/29/microsoft-dropping-web3s-for-atompub-for-windows-live-service-apis/</link>
		<comments>http://www.xlml.com/aehso/2008/02/29/microsoft-dropping-web3s-for-atompub-for-windows-live-service-apis/#comments</comments>
		<pubDate>Fri, 29 Feb 2008 12:30:25 +0000</pubDate>
		<dc:creator>aehso</dc:creator>
				<category><![CDATA[api]]></category>
		<category><![CDATA[app]]></category>
		<category><![CDATA[atompub]]></category>
		<category><![CDATA[dehora]]></category>
		<category><![CDATA[microsoft]]></category>
		<category><![CDATA[web services]]></category>

		<guid isPermaLink="false">http://www.xlml.com/aehso/2008/02/29/microsoft-dropping-web3s-for-atompub-for-windows-live-service-apis/</guid>
		<description><![CDATA[Big switch in direction from Microsoft, it would appear they are now planning to use AtomPub instead of Web3S for Windows Live service APIs they&#8217;ll formally be announcing at Mix&#8217;08.&#38;nbsp; As usual, Dare has all the details.
This is a huge endorsement for AtomPub &#8211; I&#8217;ll bet Bill is delighted (hey, I can even tell him [...]]]></description>
			<content:encoded><![CDATA[<p>Big switch in direction from Microsoft, it would appear they are now planning to use <a href="http://atompub.org/">AtomPub</a> instead of <a href="http://dev.live.com/livedata/web3s.htm">Web3S</a> for Windows Live service APIs they&#8217;ll formally be announcing at Mix&#8217;08.&amp;nbsp; As usual, <a href="http://www.25hoursaday.com/weblog/2008/02/28/WindowsLivePlatformNewsMicrosoftStandardizesOnAtomPubForWebServicesAndOtherStories.aspx">Dare has all the details</a>.</p>
<p>This is a huge endorsement for AtomPub &#8211; I&#8217;ll bet <a href="http://dehora.net/journal/">Bill</a> is delighted (hey, I can even tell him in person at <a href="http://iwtc.firstport.ie/lecture.aspx?lid=91">his IWTC talk</a> in an hours time&#8230;)</p>
]]></content:encoded>
			<wfw:commentRss>http://www.xlml.com/aehso/2008/02/29/microsoft-dropping-web3s-for-atompub-for-windows-live-service-apis/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>OpenSocial Doc Review Part 1 : Data APIs are all AtomPub based.</title>
		<link>http://www.xlml.com/aehso/2007/11/02/opensocial-doc-review-part-1-data-apis-are-all-atompub-based/</link>
		<comments>http://www.xlml.com/aehso/2007/11/02/opensocial-doc-review-part-1-data-apis-are-all-atompub-based/#comments</comments>
		<pubDate>Fri, 02 Nov 2007 12:22:46 +0000</pubDate>
		<dc:creator>aehso</dc:creator>
				<category><![CDATA[api]]></category>
		<category><![CDATA[app]]></category>
		<category><![CDATA[atom]]></category>
		<category><![CDATA[atompub]]></category>
		<category><![CDATA[google]]></category>
		<category><![CDATA[opensocial]]></category>
		<category><![CDATA[social]]></category>

		<guid isPermaLink="false">http://www.xlml.com/aehso/2007/11/02/opensocial-doc-review-part-1-data-apis-are-all-atompub-based/</guid>
		<description><![CDATA[Starting to read through the OpenSocial API documentation the most striking feature is that ALL of the underlying data APIs are Atom and AtomPub based.

The People Data API exposes people (viewer, owner, friends) via Atom feed documents and Atom entry documents.  However, there is no AtomPub support for this feed so people cannot be [...]]]></description>
			<content:encoded><![CDATA[<p>Starting to read through the <a href="http://code.google.com/apis/opensocial/">OpenSocial API documentation</a> the most striking feature is that <b>ALL</b> of the underlying data APIs are <a href="http://atompub.org/rfc4287.html">Atom</a> and <a href="http://bitworking.org/projects/atom/draft-ietf-atompub-protocol-17.html">AtomPub</a> based.</p>
<ul>
<li>The <a href="http://code.google.com/apis/opensocial/docs/gdata/people/developers_guide_protocol.html">People Data API</a> exposes people (viewer, owner, friends) via Atom feed documents and Atom entry documents.  However, there is no AtomPub support for this feed so people cannot be created/updated/deleted via API.  I suspect this will cause some debate as it means some fairly critical data remains locked into the underlying OpenSocial containers</li>
<li>The <a href="http://code.google.com/apis/opensocial/docs/gdata/activities/developers_guide_protocol.html">Activities Data API</a> exposes activities (news feeds etc) as a Atom feeds.  The Activities data feed can be fully manipulated (CRUD) via Atom/AtomPub requests.</li>
<li>The <a href="http://code.google.com/apis/opensocial/docs/gdata/persistence/developers_guide_protocol.html">Persistence Data API</a> exposes name/value pair data (e.g. configuration params) as a Atom feeds.  The persistence data feed can be fully manipulated (CRUD) via Atom/AtomPub requests.</li>
</ul>
<p>I&#8217;m off for a curry but more later today.  Here&#8217;s a teaser though &#8211; authentication is a concern&#8230;.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.xlml.com/aehso/2007/11/02/opensocial-doc-review-part-1-data-apis-are-all-atompub-based/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Wordpress 2.3 ships, with APP support.</title>
		<link>http://www.xlml.com/aehso/2007/09/25/wordpress-23-ships-with-app-support/</link>
		<comments>http://www.xlml.com/aehso/2007/09/25/wordpress-23-ships-with-app-support/#comments</comments>
		<pubDate>Tue, 25 Sep 2007 19:55:27 +0000</pubDate>
		<dc:creator>aehso</dc:creator>
				<category><![CDATA[api]]></category>
		<category><![CDATA[app]]></category>
		<category><![CDATA[rss]]></category>
		<category><![CDATA[wordpress]]></category>

		<guid isPermaLink="false">http://www.xlml.com/aehso/2007/09/25/wordpress-23-ships-with-app-support/</guid>
		<description><![CDATA[Great to see Wordpress 2.3 shipping with support for Atom 1.0 and APP (draft 17 compliant I&#8217;m guessing).  I haven&#8217;t updated this blog yet (for fear of borking plugins/themes that I have enabled) but from playing with a local test install this afternoon I see Wordpress now publishes the following feed URLs out of [...]]]></description>
			<content:encoded><![CDATA[<p>Great to see <a href="http://wordpress.org/development/2007/09/wordpress-23/">Wordpress 2.3 shipping with support for Atom 1.0 and APP</a> (<a href="http://bitworking.org/projects/atom/draft-ietf-atompub-protocol-17.html#crwp">draft 17 compliant</a> I&#8217;m guessing).  I haven&#8217;t updated this blog yet (for fear of borking plugins/themes that I have enabled) but from playing with a local test install this afternoon I see Wordpress now publishes the following feed URLs out of the box:</p>
<ol>
<li><code>&lt;wordpress-root-URL&gt;/?feed=atom</code> &#8211; Atom 0.3 format feed</li>
<li><code>&lt;wordpress-root-URL&gt;/?feed=rss</code> &#8211; RSS 0.92 format feed</li>
<li><code>&lt;wordpress-root-URL&gt;/wp-app.php/service</code> &#8211; APP Service</li>
<li><code>&lt;wordpress-root-URL&gt;/wp-app.php/posts</code> &#8211;  &#8220;Wordpress Posts&#8221; APP collection feed</li>
<li><code>&lt;wordpress-root-URL&gt;/wp-app.php/categories</code> &#8211;  &#8220;Wordpress Posts&#8221; APP category document</li>
<li><code>&lt;wordpress-root-URL&gt;/wp-app.php/attachments</code> &#8211;  &#8220;Wordpress Media&#8221; (attachments?) APP Collection</li>
</ol>
<p>I am a little curious about why the HTML doesn&#8217;t contain a &lt;link&gt; for 4 though &#8211; its absence makes it kind of difficult to auto discover the collection feed URL.   I&#8217;m also curious why both 1. and 4. exist.  I always assumed that the APP collections would just point to the real Atom feed URL, with APP clients authenticating to send HTTP POST, PUT and DELETE requests.  Was this necessary because of <a href="http://www.tbray.org/ongoing/When/200x/2007/09/14/Lousy-Aggregators">bad feed readers/aggregators</a> or was my assumption just plain wrong?</p>
<p><strong>Update:  Sam Ruby <a href="http://intertwingly.net/blog/2007/09/25/Wordpress-Atom-Futures">has some good commentary</a>, doesn&#8217;t answer my question though&#8230;</strong></p>
]]></content:encoded>
			<wfw:commentRss>http://www.xlml.com/aehso/2007/09/25/wordpress-23-ships-with-app-support/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		</item>
		<item>
		<title>Facebook Platform Bug Tracking &#8211; Finally!</title>
		<link>http://www.xlml.com/aehso/2007/09/24/facebook-platform-bug-tracking-finally/</link>
		<comments>http://www.xlml.com/aehso/2007/09/24/facebook-platform-bug-tracking-finally/#comments</comments>
		<pubDate>Mon, 24 Sep 2007 21:37:29 +0000</pubDate>
		<dc:creator>aehso</dc:creator>
				<category><![CDATA[api]]></category>
		<category><![CDATA[facebook]]></category>
		<category><![CDATA[scm]]></category>

		<guid isPermaLink="false">http://www.xlml.com/aehso/2007/09/24/facebook-platform-bug-tracking-finally/</guid>
		<description><![CDATA[It&#8217;s almost incredible to believe that Facebook application developers have put up with using discussion forums to report, discuss and track bugs in the Facebook Platform while it is in constant use by 40million+ users but Facebook have finally launched a Bugzilla based bug tracking site.  
One might be forgiven for thinking they survived [...]]]></description>
			<content:encoded><![CDATA[<p>It&#8217;s almost incredible to believe that Facebook application developers have put up with using discussion forums to report, discuss and track bugs in the <a href="http://developer.facebook.com/">Facebook Platform</a> while it is in constant use by 40million+ users but Facebook have finally launched a <a href="http://bugs.developers.facebook.com/">Bugzilla based bug tracking</a> site.  </p>
<p>One might be forgiven for thinking they survived this long because the platform API is rock solid but their tendency to roll out nightly <a href="http://www.facebook.com/feeds/api_messages.php">updates that break very visible platform APIs</a> every few days contradicts that slightly.  We scratched our head for few hours a while back when the mock Ajax APIs that our application profile boxes were using suddenly started presenting the user with misleading error dialog boxes, only to find out that the platform API had accidentally been busted the previous night.   I&#8217;d imagine there&#8217;s been a lot of time wasted by a lot of application developers over the past year while tracking down similar incidents but they have been incredibly patient in waiting this long.</p>
<p>One thing I would love Facebook to add is a <a href="http://wiki.developers.facebook.com/index.php/FBML">FBML</a> tag that gives the application developers extra debug/trace info while running/debugging their application but until now I&#8217;ve had no decent way to know if something like this isn&#8217;t already in the works.  Something like a <code>fb:is-app-developer</code>, or a magic debug/trace div beneath the application div might be nice.  Or they could just open source their FBML->HTML rendering engine and then 3rd parties could go about developing decent tools to aid debugging (I suspect this is already being reverse engineered though anyway&#8230;)</p>
<p>Better later than never though I suppose.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.xlml.com/aehso/2007/09/24/facebook-platform-bug-tracking-finally/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Brad Fitzpatrick&#8217;s Social Graph Problem.</title>
		<link>http://www.xlml.com/aehso/2007/08/22/brad-fitzpatricks-social-graph-problem/</link>
		<comments>http://www.xlml.com/aehso/2007/08/22/brad-fitzpatricks-social-graph-problem/#comments</comments>
		<pubDate>Wed, 22 Aug 2007 14:03:12 +0000</pubDate>
		<dc:creator>aehso</dc:creator>
				<category><![CDATA[api]]></category>
		<category><![CDATA[facebook]]></category>
		<category><![CDATA[internet]]></category>
		<category><![CDATA[openid]]></category>
		<category><![CDATA[social]]></category>
		<category><![CDATA[web2.0]]></category>

		<guid isPermaLink="false">http://www.xlml.com/aehso/2007/08/22/brad-fitzpatricks-social-graph-problem/</guid>
		<description><![CDATA[Ronan pointed me to an interesting Wired blog entry on Brad Fitzpatrick&#8217;s social graph problem.  The social graph problem requires many of solutions that Dion&#8217;s Dream River needs so I was going to just comment that it will take a long time for any of this to happen (thankfully Brads essay openly calls this [...]]]></description>
			<content:encoded><![CDATA[<p><a href="http://ronanboylan.blogspot.com/">Ronan</a> pointed me to an interesting <a href="http://blog.wired.com/monkeybites/2007/08/brad-fitzpatric.html">Wired blog entry</a> on Brad Fitzpatrick&#8217;s <a href="http://bradfitz.com/social-graph-problem/">social graph problem</a>.  The social graph problem requires many of solutions that <a href="http://www.xlml.com/aehso/2007/07/29/dions-dream-river/">Dion&#8217;s Dream River</a> needs so I was going to just comment that it will take a long time for any of this to happen (thankfully Brads essay openly calls this out).  </p>
<p>Then I read that <a href="http://valleywag.com/tech/brad-fitzpatrick/livejournal-creator-leaves-as-six-apart-fails-to-spin-286218.php">Brad might be joining Google</a>.  So I&#8217;ve changed my comment to &#8220;it might happen just a little bit sooner&#8221;.&nbsp; This is just the type of problem that the folks at Google love to try solve&#8230;</p>
]]></content:encoded>
			<wfw:commentRss>http://www.xlml.com/aehso/2007/08/22/brad-fitzpatricks-social-graph-problem/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Dion&#8217;s Dream River</title>
		<link>http://www.xlml.com/aehso/2007/07/29/dions-dream-river/</link>
		<comments>http://www.xlml.com/aehso/2007/07/29/dions-dream-river/#comments</comments>
		<pubDate>Sun, 29 Jul 2007 18:45:01 +0000</pubDate>
		<dc:creator>aehso</dc:creator>
				<category><![CDATA[api]]></category>
		<category><![CDATA[facebook]]></category>
		<category><![CDATA[mac]]></category>
		<category><![CDATA[openid]]></category>
		<category><![CDATA[social]]></category>
		<category><![CDATA[web2.0]]></category>

		<guid isPermaLink="false">http://www.xlml.com/aehso/2007/07/29/dions-dream-river/</guid>
		<description><![CDATA[Now that I&#8217;ve been using Facebook, LinkedIn and Twitter for a while I&#8217;m beginning to notice fragmentation of my contact network and event streams.&#160; The problem goes a little deeper than &#8220;should I twitter this or/and update my FB status?&#8221; or &#8220;should I add her as a friend in Facebook or LinkedIn?&#8221;.&#160; 
Then there is [...]]]></description>
			<content:encoded><![CDATA[<p>Now that I&#8217;ve been using <a href="http://www.facebook.com/profile.php?id=690057040">Facebook</a>, <a href="http://www.facebook.com/profile.php?id=690057040">LinkedIn</a> and <a href="http://twitter.com/aehso">Twitter</a> for a while I&#8217;m beginning to notice fragmentation of my contact network and event streams.&nbsp; The problem goes a little deeper than &#8220;should I twitter this or/and update my FB status?&#8221; or &#8220;should I add her as a friend in Facebook or LinkedIn?&#8221;.&nbsp; </p>
<p>Then there is also network replication to deal with &#8211; I&#8217;m getting multiple friend invites for the same people, many of whom are already in my (private) contacts list.&nbsp; Don&#8217;t get me wrong, I like connecting with people!&nbsp; I&#8217;m just finding myself wishing that there was a better mechanism through which all this stuff can be synchronized though.&nbsp; It turns out <a href="http://www.almaer.com/blog/archives/001547.html">Dion Almer is finding himself dreaming up a solution he calls The River</a>:
</p>
<blockquote><p>In the dream I developed an application called &#8220;The River&#8221; that was a filthy rich UI that showed your one main river of events, and various rivers that would run into the main one.  The river would contain: Incoming email, Status events from fb, twitter, pownce, Cool.Next, Event invites, Blog entries via rss, Photos uploaded, etc.</p></blockquote>
<p>Dion adds a nice kicker when he suggests the following feature:</p>
<blockquote><p>When a user signs up, they are asked for their FB/gmail/linkedin id to find people / invite them. Most services do that right now. However, there is an extra check box which states &#8220;if you see me connected on another network, automatically connect me here&#8221;. This means that you don&#8217;t have to keep accepting friend invites from the same people again and again. You should virally, quite quickly, get all of your contacts sync&#8217;d up.</p></blockquote>
<p>I think this is an excellent suggestion but I&#8217;d take it one step further.&nbsp; The River needs to do this continuously, effectively acting as an <a href="http://en.wikipedia.org/wiki/Intelligent_agent">intelligent agent</a>.&nbsp; Unfortunately there are two major barriers to this ever happening:
<ul>
<li>The agent needs to be able to verify user identities.&nbsp; For example it needs to be sure that the John O&#8217;Shea in your network is me, not <a href="http://en.wikipedia.org/wiki/John_O%27Shea_%28footballer%29">the footballer</a>, the <a href="http://en.wikipedia.org/wiki/John_O%27Shea_%28director%29">filmmaker</a> or the <a href="http://en.wikipedia.org/wiki/John_O%27Shea_%28humanitarian%29">humanitarian</a>.&nbsp; I can and do play football, shoot home movies and donate to charities but I&#8217;m not those people.&nbsp; One problem here is none of the major social networks support associating an <a href="http://openid.net/">OpenID</a> with a user profile so by consequence none have the required APIs.&nbsp; A second problem is not many people have OpenIDs yet (that reminds me&#8230;)</li>
<li>The agent needs read/write&nbsp; to the users contacts and event streams within each social network.&nbsp; Read can be done via RSS feeds, but write needs HTTP API access.&nbsp; Of the networks I mentioned above, Facebook(<a href="http://developers.facebook.com/documentation.php?v=1.0&amp;method=feed.publishStoryToUser">api</a>) and Twitter(<a href="http://groups.google.com/group/twitter-development-talk/web/api-documentation">api</a>) provide this LinkedIn doesn&#8217;t (yet &#8211; they are working on APIs though).&nbsp; The walled garden social network sites like MySpace and Bebo really won&#8217;t want to ever provide this.</li>
</ul>
<p>If OpenID gains more momentum then I think all of the above is do-able.&nbsp; I am of course ignoring the walled garden networks but over time they will seem more and more antiquated to their users and their influence will diminish.</p>
<p>This is, of course, all an extension of the older problem of synchronizing contact information between multiple email accounts and mobile phones and that nut still isn&#8217;t completely cracked.&nbsp; <a href="http://www.apple.com/macosx/features/isync/">iSync</a> solved this to an extent but it (still) doesn&#8217;t have any decent Google mail/calendar integration. (I&#8217;ve tried <a href="http://homepage.mac.com/bharley/BenAppleScripts/FileSharing19.html">ABGMerge</a> but it created a mess to the extent that I had to revert to backups. This is becoming a real pain for me as I ditched my .mac subscription last year and I&#8217;m mainly using gmail now &#8211; suggestions welcome!)</p>
<p>Meanwhile something is going to have to give, and I think the first service I&#8217;ll drop is Twitter&#8230;</p>
]]></content:encoded>
			<wfw:commentRss>http://www.xlml.com/aehso/2007/07/29/dions-dream-river/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>

