A portion of the Facebook developer API has been integrated into Sharendipity through the REST interface. Users may create new REST services which point at the Sharendipity server, and those calls are proxied on your behalf to Facebook.

We provide a proxied version of the API to avoid the need for you to authenticate. Our server is already aware that you've logged in and can therefore manage the authentication and application key management with Facebook. This provides a straight forward way for you to access the data you are most interested in and not worry about the overhead.

REST calls to our server explicitly follow the Facebook API minus the authentication parameters. The format of the REST URL is the following...
URL : http://beta.sharendipity.com/rest/facebook/
Input 1 : 'function' (one of the supported functions listed below)
Input 2-n : parameters defined by the API for the respective function

For complete documentation of the Facebook API, please reference their developer's wiki.

We currently support the following API methods. If there are other methods that you would like us to add, justlet us know!

• friends.get - Retrieve all friends for the user currently logged in.

• No function inputs are required.

• groups.get - Retrieve the groups that a user is a part of.

• Input : uid - Facebook user ID. If the UID is not specified, we will default to the user currently logged in. Not required.

• Input : gids - Facebook group ID. Not required.

• groups.getMembers - Retrieve a list of users that belong to a particular group.

• Input : gid - Facebook group ID. Required.

• photos.get - Retrieve all photos a user is tagged in.

• Input : subj_id - Facebook user ID(s). Not required. Filter by photos tagged with user(s) described by subj_id. Multiple IDs should be seperated by commas. If the UID is not specified, we will default to the user currently logged in.

• Input : aid - Facebook photo album ID. Filter by photos in this album. Not required.

• Input : pids - Facebook photo ID(s). Filter by photos in this list. Not required.

• photos.getAlbums - Retrieve a list of albums created by a user.

• Input : uid - Facebook user ID. If the UID is not specified, we will default to the user currently logged in. Not required.

• Input : aids - Facebook photo album ID. Not required.

• users.getInfo - Retrieve the profile information for a user.

• Input : uids - Facebook user ID. If the UID is not specified, we will default to the user currently logged in. Not required.

• Input : fields - A list of profile fields to retrieve. If not specified, a limited set of profile information will be returned. See the API documentation for the list of field names. Not required.

For an example of these services being used, take a look at theFacebook Fishbowl application. This application uses the REST interfaces to display the status of your friends. There are plenty of REST services that have already been created and shared, so search the community for "facebook" or "REST" to see what is already available to you.