Example API from Joakim Söderberg on 2009-01-08 (public-media-annotation@w3.org from January 2009)

From: Joakim Söderberg <joakim.soderberg@ericsson.com>
Date: Thu, 8 Jan 2009 14:53:59 +0100
To: <public-media-annotation@w3.org>
Message-ID: <4055256AED9D224D9442B19BF1C4C4900319964E@esealmw118.eemea.ericsson.se>

Hello all,
I think http://apiwiki.twitter.com/REST+API+Documentation
constitutes a nice example of an API spec:


User Methods
friends
Returns up to 100 of the authenticating user's friends who have most recently updated, each with current status inline. It's also possible to request another user's recent friends list via the id parameter below. 

 URL: http://twitter.com/statuses/friends.format

Formats: xml, json

Method(s): GET

Parameters:

id.  Optional.  The ID or screen name of the user for whom to request a list of friends.  Ex: http://twitter.com/statuses/friends/12345.json or http://twitter.com/statuses/friends/bob.xml 
page.  Optional. Retrieves the next 100 friends.  Ex: http://twitter.com/statuses/friends.xml?page=2

Received on Thursday, 8 January 2009 13:54:35 UTC