W3C home > Mailing lists > Public > public-media-annotation@w3.org > January 2009

Example API

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

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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 8 January 2009 13:54:36 GMT