Phillip Pearson - Second p0st

tech notes and web hackery from the guy that brought you bzero, python community server, the blogging ecosystem, the new zealand coffee review and the internet topic exchange

2006-5-17

REST APIs adopting a standard format

It looks like the response structure of the BBC API is based on that of the Flickr API. I've also seen this format used in the Zoomin places/groups API.

Googling for rsp stat ok standard rest format reveals a couple more apps using the same format.

I was thinking about using this format for the REST/XML version of the PeopleAggregator API, but I had decided against it because it would be inconsistent with the XML-RPC and REST/JSON versions. But now that it seems that everyone else is using it, I guess I should reconsider :-)

Update: Michael Fagan encourages basing APIs on RSS/Atom + Atom-Pub + OpenSearch, i.e. like GData. That approach is appealing, although I expect it would be significantly more difficult to code against than an XML-RPC or JSON API.

Update 2: Looks like I got Marc worried - I've clarified this post over in his comments.