The Friendster Developer Platforms provide APIs to access Friendster data and seamless integration points within the Friendster web site to create compelling games for Friendster's userbase.

Platform V1 and the common integration points are described in the following sections of this page.

Platform V1 APIs provides access to Friendster data through a rich REST-style interface. These resources can be accessed using an API key and a shared secret key that is issued to every game or 'Friendster App'. The resources can be accessed at the endpoint http://api.friendster.com/v1

App developers provide the following information to get listed in Friendster's Game Portal and to get an API Key and API Secret to access Friendster data:

Friendster provides the following keys which are used for every API call:

The current list of resources supported by the platform is as follows:

The following are the current integration points within the Friendster website:

For more information about the Friendster Developers Platform, email developersupport@friendster.com.
To register your app, click here.

Every API request should have the following attributes:

Example:

For instance for the following request:

http://api.friendster.com/v1/user/57519?
api_key=2e37638f335f0545c3719d34f4d20ed0&
session_key=M4yZuZ4LjoJQj5BJfTkw2HnGw6MG8JyM-57519&
nonce=326233766.3425

The signature is computed as follows, shown here in PHP syntax:

md5(
  '/v1/user/57519' .
  'api_key=2e37638f335f0545c3719d34f4d20ed0' .
  'nonce=326233766.3425' .
  'session_key=M4yZuZ4LjoJQj5BJfTkw2HnGw6MG8JyM-57519' .
  '<secret_key>');

The Playground Page is accessed through the Game playground URL which is a public URL which uniquely identifies your game. It accepts the game unique name:

'http://www.friendster.com/play/<app_name>'

All references within Friendster use the callback URL.

An iframe is created within this page and your game's callback_url is called with the following parameters attached:

Example:

For instance the following Canvas URL for the app 'slideshow':

http://www.friendster.com/play/avatarstore/show1?view=mostrecent&instance_id=3745

The Callback URL 'http://mydomain/apps/1445' would be called as follows within the App Canvas page:

http://mydomain/apps/1445/show1?
  view=mostrecent&
  instance_id=3745&
  user_id=57519&
  api_key=2e37638f335f0545c3719d34f4d20ed0&
  api_domain=api.friendster.com&
  sandbox=false&
  signed_keys=view,instance_id,user_id,api_key,api_domain,sandbox,signed_keys,src,session_key,expires,lang,nonce&
  src=profile&
  session_key=M4yZuZ4LjoJQj5BJfTkw2HnGw6MG8JyM-57519&
  expires=0&
  lang=en-US&
  nonce=326233766.3425&
  sig=012345678901234567890123456789012

Friendster allows for users who have not registered or logged in to friendster to be able to play your game. This mode of access is called "guest mode". So what happens under guest mode?

• During guest mode a unique user (or avatar) id is automatically created and assigned to an api session that is passed to your app.
• To let you know that the current session is under guest mode, a guest=true flag is passed to your iframe
• Friendster will display a notice to remind the user to register if they want to save the current game state. The uid of a user will not change once they do register.

Do note that users under guest mode are not verified by friendster, as such you may opt to put in additional security measures that would prevent guest mode accounts from abusing your game (e.g. spam etc.)

The signature is used to verify that a http request sent to the Friendster API indeed came from your game. To start we will need use the /v1/user call as an example:

http://api.friendster.com/v1/user/3448717?
nonce=177620106727976&api_key=ae17c149bedab7ecf731075eb14934a7&
session_key=b2abf542-9a5e-168c-6b29-4978de11c772

let us also assume the following:

api key: ae17c149bedab7ecf731075eb14934a7
api secret: b93d67ad280ab7bbe6fcd0197cbbc191

In order to compute for the signature correctly you need to do the following steps:

• Extract the path from the url, remove the protocols and the domain:

• Extract all the parmeters including the '=' sign, also if a parameter is URL encoded they should be unencoded during this computation.

  session_key=b2abf542-9a5e-168c-6b29-4978de11c772
  api_key=ae17c149bedab7ecf731075eb14934a7
  nonce=177620106727976

• Sort those parameters in alphabetical order

  api_key=ae17c149bedab7ecf731075eb14934a7
  nonce=177620106727976
  session_key=b2abf542-9a5e-168c-6b29-4978de11c772

• concatenate the path and the parameters together

• concatenate your secret key at the end and then compute for the md5

  md5(/v1/user/3448717
  api_key=ae17c149bedab7ecf731075eb14934a7
  nonce=177620106727976
  session_key=b2abf542-9a5e-168c-6b29-4978de11c772b93d67ad280ab7bbe6fcd0197cbbc191)

  resulting signature from the computation => cf0e0334e5aa4d6f16e9ba038252385a

• URL encode all parameter values, set the value to sig and add it to your final url request.

  http://api.friendster.com/v1/user/3448717?
  nonce=177620106727976&api_key=ae17c149bedab7ecf731075eb14934a7&
  session_key=b2abf542-9a5e-168c-6b29-4978de11c772&
  sig=cf0e0334e5aa4d6f16e9ba038252385a

Examples

Sample # 1:

api key: 370d00bfb0217e651b29891d09a201b0
api_secret: 783a78da225de83c7169c32ef62193c7
sample url: http://api.friendster.com/wallet/sandbox_authenticate?
api_key=370d00bfb0217e651b29891d09a201b0&
request_token=ed836ef9e96c1466315b42ce866360&
return_url=http%3A%2F%2Fwww.friendster.com

concatenated string: "/wallet/sandbox_authenticateapi_key=370d00bfb0217e651b29891d09a201b0request_token=ed836ef9e96c1466315b42ce866360return_url=http://www.friendster.com783a78da225de83c7169c32ef62193c7"

final URL with Signature

http://api.friendster.com/wallet/sandbox_authenticate?api_key=370d00bfb0217e651b29891d09a201b0&
request_token=ed836ef9e96c1466315b42ce866360&
return_url=http%3A%2F%2Fwww.friendster.com&
sig=62a2519e7544cae6c84ed8c3422822d7

Friendster has a page where you can redirect to in order to let users share your game to their friends. The URL syntax is as follows:

http://www.friendster.com/app_share/show?api_key=e59ff97941044f85df5297e1c302d260&
next=http://www.google.com

Also, when a user accepts the game invite, they will be redirected to your game play page with the referrer_uid parameter passed to your callback_url (e.g. www.friendster.com/play/mygame?referrer_uid=34245542)

The following parameters are accepted:

Sample Usage:

<a target="_blank" href="http://www.friendster.com/app/share?api_key=6b9569e1a8074ebf972aa9eb2d725f9e
&next=http://smackaho.st:8080/play/avatarstore">Share this app to your friends</a>

SFML allows games to be able to post content on the user's wall with a rich formatting while making sure that the content is secure. Similar to XHTML each tag must be properly closed, otherwise an error will be thrown if it is not.

This section describes allowable tags for APIs that accept SFML templates, like POST /v1/wall

The following HTML tags are supported, however you are not allowed to specifiy any attributes.

<p> <b> <i> <u> <br/> <hr> <h1> <center>

You can use the tool below to preview SFML markup when rendered on the user's wall.

Get User Information

Resource URL: http://api.friendster.com/v1/user/<UID> or http://api.friendster.com/v1/user?uids=<UIDS>

Resource Methods: GET (Retrieval of user information) : POST (Retrieval of user information)

Resource Description: API to get information on one or more avatars. If no avatar ID is specified, information about current logged in avatar will be returned.

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/user/57519?
    api_key=2e37638f335f0545c3719d34f4d20ed0&
    session_key=M4yZuZ4LjoJQj5BJfTkw2HnGw6MG8JyM-57519&
    nonce=326233766.3425&
    sig=012345678901234567890123456789012

http://api.friendster.com/v1/user?uids=57519&
    api_key=2e37638f335f0545c3719d34f4d20ed0&
    session_key=M4yZuZ4LjoJQj5BJfTkw2HnGw6MG8JyM-57519&
    nonce=326233766.3425&
    sig=012345678901234567890123456789012

Example Response (XML) :

<?xml version="1.0" encoding="UTF-8" ?>
<user_response xmlns="http://api.friendster.com/v1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://api.friendster.com/v1/friendster.xsd">
    <user>
        <uid>635423412</uid>
        <first_name><![CDATA[John]]></first_name>
        <last_name><![CDATA[doe]]></last_name>
        <url>http://profiles.friendster.com/635423412</url>
        <primary_photo_url>http://photos.friendster.com:81/photos/43/09/45345/1_620223562m.jpg</primary_photo_url>
        <location>
            <country>US</country>
            <state>CA</state>
            <city>California</city>
        </location>
        <hometown><![CDATA[san francisco]]></hometown>
        <user_type>Normal</user_type>
        <fan_profile_type>None</fan_profile_type>
        <fan_profile_category>None</fan_profile_category>
        <relationship_status>Single</relationship_status>
        <gender>Male</gender>
        <member_since>
            <year>2003</year>
            <month>02</month>
        </member_since>
        <interested_in list="true">
            <interest>Friends</interest>
            <interest>Activity Partners</interest>
        </interested_in>
        <occupation><![CDATA[Programmer]]></occupation>
        <companies></companies>
        <hobbies_and_interests></hobbies_and_interests>
        <affiliations></affiliations>
        <college_list list="true">
            <college>
                <name><![CDATA[University of California - Davis]]></name>
                <region>California</region>
                <country>United States</country>
                <city></city>
                <year_start>2000</year_start>
                <year_end>2003</year_end>
                <major><![CDATA[Communications]]></major>
                <degree>127</degree>
                <course></course>
                <class_of>2002</class_of>
            </college>
        </college_list>
        <school_list list="true">
            <school>
                <name><![CDATA[Joplin High]]></name>
                <region>Missouri</region>
                <country>United States</country>
                <city>Joplin</city>
                <year_start>2000</year_start>
                <year_end>2004</year_end>
                <major></major>
                <degree>0</degree>
                <course></course>
                <class_of>2004</class_of>
            </school>
        </school_list>
        <school_other></school_other>
        <favorites>
            <books><![CDATA[Confessions of a Shopaholic]]></books>
            <movies><![CDATA[Ferris Bueller's Day Off, Friday, Goonies, Zoolander, 50 First Dates, Elf]]></movies>
            <music><![CDATA[all kinds...it just depends on the mood]]></music>
            <tv_shows><![CDATA[24 BABY!!!!!  SNL, Conan O'Brien, Friends, Reality TV...esp. American Idol,
 CSI, Nip Tuck, Chappelle's Show]]></tv_shows>
        </favorites>
        <about_me><![CDATA[I'm John Doe]]></about_me>
        <want_to_meet><![CDATA[Anyone who wants to be my friend]]></want_to_meet>
        <birthday>
            <year>1984</year>
            <month>07</month>
            <day>25</day>
        </birthday>
    </user>
</user_response>

Example Error Response :

<error_response xmlns="<http://api.friendster.com/v1/>"
    xmlns:xsi="<http://www.w3.org/2001/XMLSchema-instance>"
xsi:schemaLocation="http://api.friendster.com/v1/
http://api.friendster.com/v1/friendster.xsd">
<error_code>7</error_code>
<error_msg>Unauthorized source IP address (ip was: 10.1.2.3)</error_msg>
</error_response>

Get Friends List

Resource URL : http://api.friendster.com/v1/friends/<UID>

Resource Methods : GET (Retrieval of friends list)

Resource Description : API to get the friends list of a user. If no user ID is specified, the friends list of the current logged in user will be returned.

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/friends/57519?
     api_key=2e37638f335f0545c3719d34f4d20ed0&
     session_key=M4yZuZ4LjoJQj5BJfTkw2HnGw6MG8JyM-57519&
     nonce=326233766.3425&
     sig=012345678901234567890123456789012

Example Response (XML) :

<friends_response xmlns="http://api.friendster.com/v1/"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://api.friendster.com/v1/
     http://api.friendster.com/v1/friendster.xsd">
   <friends list="true">
      <uid>57519</uid>
      <uid>12989</uid>
      <uid>57908</uid>
      <uid>48999</uid>
      <uid>37529</uid>
      <uid>97510</uid>
   </friends>
</friends_response>

Post Shoutout

Resource URL :http://api.friendster.com/v1/shoutout

Resource Method : POST (Updates the shoutout for the current user)

Resource Description : This API updates the shoutout of the current logged in user. If an empty value is passed as content, the current user shoutout will be cleared.

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/shoutout
::Content-Type: multipart/form-data; boundary=xxx
MIME-version: 1.0

--xxx
Content-Disposition: form-data; name="content"

Traveling to Vegas!

Example Response (XML) :

<shoutout_response xmlns="http://api.friendster.com/v1/"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://api.friendster.com/v1/friendster.xsd">
    <status>updated</status>
</shoutout_response>

Example Error Response :

<error_response xmlns="<http://api.friendster.com/v1/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://api.friendster.com/v1/">
    <error_code>104</error_code>
    <error_msg>Invalid signature</error_msg>
</error_response>

Get Shoutout

Resource URL :http://api.friendster.com/v1/shoutout(/:user_id)

Resource Method : GET (Retrieves the shoutout of the current user if user_id is not specified. Otherwise, it gets the shoutout of the given user_id if present.)

Resource Description : This API gets the shoutout of the currently logged in user or the provided user_id if present.

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/shoutout/1234

Example Response (XML) :

<shoutout_response xmlns="http://api.friendster.com/v1/"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://api.friendster.com/v1/friendster.xsd">
    <shoutouts>
      <uid>1234</uid>
      <shoutout>Hello world!</shoutout>
      <time>1317277054</time>
    </shoutouts>
</shoutout_response>

Example Error Response :

<error_response xmlns="<http://api.friendster.com/v1/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://api.friendster.com/v1/">
    <error_code>104</error_code>
    <error_msg>Invalid signature</error_msg>
</error_response>

Post Notification

Resource URL:

http://api.friendster.com/v1/notification
http://api.friendster.com/v1/notification/<uids>

Resource Method: POST (generate a notification)

Resource Description: API to generate a notification to the uids listed in the resource URL on behalf of the logged in user. If no uids are provided, the notification is generated for the logged in user. There is a limit to the number of notifications a user can receive per day from a single game. When a user receives an app notification, "NEW app notifications" displays in the notification panel in the logged in homepage. The notifications appear in the user's app notifications page as follows:

Request:

Response :

Error Conditions/Response :

Example Request:

    http://api.friendster.com/v1/notification/53642,72361,4734?type=1&
    api_key=2e37638f335f0545c3719d34f4d20ed0&content=hello%20world&
    subject=hello%20world%20app&label=click%20here&sig=fake_sig

Example Response (XML):

<?xml version="1.0" encoding="UTF-8"?>
<notifications_response
    xmlns="<%3Chttp://api.friendster.com/v1/>"xmlns:xsi="<http://www.w3.org/2001/XMLSchema-instance>"
    xsi:schemaLocation="http://api.friendster.com/v1/ <http://api.friendster.com/v1/friendster.xsd>"
    list="true">
       <uid>53642</uids>
       <uid>72361</uids>
       <uid>4734</uids>
</notifications_response>

Example Error Response (XML):

<error_response xmlns="<http://api.friendster.com/v1/>"
    xmlns:xsi="<http://www.w3.org/2001/XMLSchema-instance>"
    xsi:schemaLocation="http://api.friendster.com/v1/
    http://api.friendster.com/v1/friendster.xsd">
    <error_code>100</error_code>
    <error_msg>Missing parameters from notification</error_msg>
</error_response>

Get Game friends

Resource URL:

http://api.friendster.com/v1/application/friends

Resource Method:

GET (obtain list of friends who have played the game at least once)

Resource Description:

This API returns the list of friends who have already played the game at least once.

Request :

Response :

Error Conditions/Response :

Example Request:

http://api.friendster.com/v1/application/friends

Example Response (XML):

<application_friends_response xmlns="http://api.friendster.com/v1/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://api.friendster.com/v1/friendster.xsd" list="true">
    <application_friends>
      <uid>123456</uid>
      <uid>81213123</uid>
      <uid>12310993</uid>
    </application_friends>
</application_friends_response>

Example Error Response

<error_response xmlns="http://api.friendster.com/v1/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://api.friendster.com/v1/">
<error_code>104</error_code>
<error_message>Invalid signature</error_message>
</error_response>

Get Conversation List

Resource URL : http://api.friendster.com/v1/messages;

Resource Methods : GET (Retrieval of user conversations)

Resource Description : API to get the conversations list of a user.

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/messages?
     api_key=2e37638f335f0545c3719d34f4d20ed0&
     session_key=M4yZuZ4LjoJQj5BJfTkw2HnGw6MG8JyM-57519&
     nonce=326233766.3425&
     sig=012345678901234567890123456789012

Example Response (XML) :

<message_response xmlns="http://api.friendster.com/v1/"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://api.friendster.com/v1/
     http://api.friendster.com/v1/friendster.xsd">
   <messages>
      <conversation>
        <cid>55</cid>
        <latest_message_body>Private message test reply</latest_message_body>
        <sender_id>445777</sender_id>
        <sender_name>secondOne</sender_name>
        <recipient_id>445758</recipient_id>
        <recipient_name>Jay</recipient_name>
      </conversation>
      <page>1</page>
      <next_page/>
   </messages>
</message_response>

Get Message List by Conversation ID

Resource URL : http://api.friendster.com/v1/message/:cid;

Resource Methods : GET (Retrieval of user messages by conversation id)

Resource Description : API to get the message list of a user by conversation id.

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/message/120?
     api_key=2e37638f335f0545c3719d34f4d20ed0&
     session_key=M4yZuZ4LjoJQj5BJfTkw2HnGw6MG8JyM-57519&
     nonce=326233766.3425&
     sig=012345678901234567890123456789012

Example Response (XML) :

<message_response xmlns="http://api.friendster.com/v1/"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://api.friendster.com/v1/
     http://api.friendster.com/v1/friendster.xsd">
   <messages>
      <message>
        <mid>120</cid∣
        <message_body>Private message test 2</message_body>
        <message_sender_id>445758</message_sender_id>
        <message_sender_name>Jay</message_sender_name>
        <message_recipient_id>445780</message_recipient_id>
        <message_recipient_name>Marc</message_recipient_name>
      </message>
      <page>1</page>
      <next_page/>
   </messages>
</message_response>

Post a message to an avatar

Resource URL : http://api.friendster.com/v1/messages;

Resource Methods : POST (Adding Message to a conversation)

Resource Description : API to post the message of a user.

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/messages?
     api_key=2e37638f335f0545c3719d34f4d20ed0&
     recpient=9017&
     content=Hello+world&
     session_key=M4yZuZ4LjoJQj5BJfTkw2HnGw6MG8JyM-57519&
     nonce=326233766.3425&
     sig=012345678901234567890123456789012

Example Response (XML) :

<message_response xmlns="http://api.friendster.com/v1/"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://api.friendster.com/v1/
     http://api.friendster.com/v1/friendster.xsd">
   <status>created</status>
</message_response>

Delete a Message from a Conversation

Resource URL : http://api.friendster.com/v1/messages/destroy/:mid;

Resource Methods : POST (Deleting a Message from a conversation)

Resource Description : API to delete the message of a user.

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/messages/destroy/55?
     api_key=2e37638f335f0545c3719d34f4d20ed0&
     session_key=M4yZuZ4LjoJQj5BJfTkw2HnGw6MG8JyM-57519&
     nonce=326233766.3425&
     sig=012345678901234567890123456789012

Example Response (XML) :

<message_response xmlns="http://api.friendster.com/v1/"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://api.friendster.com/v1/
     http://api.friendster.com/v1/friendster.xsd">
   <status>deleted</status>
</message_response>

Get the number of new messages

Resource URL: http://api.friendster.com/v1/newmessages

Methods: GET (query the number of new messages)

Resource Description: API to query the number of new messages for the current user since the last_update (optional parameter).

Request :

Response :

Error Conditions/Response:

Example Request:

http://api.friendster.com/v1/newmessages?
    api_key=2e37638f335f0545c3719d34f4d20ed0&
    nonce=326233766.3425&
    sig=012345678901234567890123456789012

Example Response (XML):

<newmessages_response xmlns="http://api.friendster.com/v1/"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://api.friendster.com/v1/ http://api.friendster.com/v1/friendster.xsd">
     <new>5</new>
     <last_update>1112241241242424</last_update>
</newmessages_response>

Post Game Score

Resource URL : http://api.friendster.com/v1/score/:avatar_id

Resource Methods : POST (Adding game score)

Resource Description : API to post the game score of an avatar. Allows games to have a private leaderboard based on game scores. Use the op parameter to specify how the scores are to be added and updated.

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/score/11111?
     api_key=2e37638f335f0545c3719d34f4d20ed0&
     session_key=M4yZuZ4LjoJQj5BJfTkw2HnGw6MG8JyM-57519&
     nonce=326233766.3425&
     sig=012345678901234567890123456789012&
     score=100

Example Response (XML) :

<game_score_response xmlns="http://api.friendster.com/v1/"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://api.friendster.com/v1/
     http://api.friendster.com/v1/friendster.xsd">
   <status>posted</status>
</game_score_response>

Get Top Score List

Resource URL : http://api.friendster.com/v1/score

Resource Methods : GET (Retrieval of top scores of the game)

Resource Description : API to get the list of top scores of the game.

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/score?
     api_key=2e37638f335f0545c3719d34f4d20ed0&
     session_key=M4yZuZ4LjoJQj5BJfTkw2HnGw6MG8JyM-57519&
     nonce=326233766.3425&
     sig=012345678901234567890123456789012

Example Response (XML) :

<game_score_response xmlns="http://api.friendster.com/v1/"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://api.friendster.com/v1/
     http://api.friendster.com/v1/friendster.xsd">
   <high_scores>
      <score>
        <avatar_id>445695</avatar_id>
        <score>100</score>
        <posted_at>1325127188</posted_at>
      </score>
   </high_scores>
</game_score_response>

Post Game Event Log

Resource URL : http://api.friendster.com/v1/event/log

Resource Methods : POST (Add a game event)

Resource Description : API to post an event log entry which the user can view privately. Games can post in-game event messages here and where the user can choose to review later

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/event/log?
     api_key=2e37638f335f0545c3719d34f4d20ed0&
     session_key=M4yZuZ4LjoJQj5BJfTkw2HnGw6MG8JyM-57519&
     nonce=326233766.3425&
     sig=012345678901234567890123456789012&
     score=100

Example Response (XML) :

<game_score_response xmlns="http://api.friendster.com/v1/"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://api.friendster.com/v1/
     http://api.friendster.com/v1/friendster.xsd">
   <status>posted</status>
</game_score_response>

Query available points

Resource URL :http://api.friendster.com/v1/points/:uid

Resource Method : GET (Query the users' maximum points that can be awarded for the day)

Resource Description : This API allows you to query the maximum points that can be awarded to a user for the day. It is advised to use this API first to determine eligibility before proceeding to award the user with points using the POST points API.

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/points?uid=1234456&points=40

Example Response (XML) :

<?xml version="1.0" encoding="UTF-8"?>
<points_response xmlns="http://api.friendster.com/v1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://api.friendster.com/v1/ http://api.friendster.com/v1/friendster.xsd">
  <available_points>1000000</available_points>
</points_response>

Example Error Response :

<error_response xmlns="<http://api.friendster.com/v1/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://api.friendster.com/v1/">
    <error_code>104</error_code>
    <error_msg>Invalid signature</error_msg>
</error_response>

Post points

Resource URL :http://api.friendster.com/v1/points

Resource Method : POST (Add points to a user)

Resource Description : This API adds points to a user. The user must have played your game at least once. Points allow users' to level up, get rewards and climb the guild and avatar leaderboards, use this API to give incentives to users while ingame.

Note: As a publisher of your game, your own avatar(s) is/are not eligible for points rewards. However, you will still receive popup points notifications coming from your game in order to test the 'message' parameter.

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/points?uid=1234456&points=40

Example Response (XML) :

<points_response xmlns="http://api.friendster.com/v1/"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://api.friendster.com/v1/friendster.xsd">
    <status>OK</status>
    <uid>446259</uid>
    <points>100</points>
</points_response>

Example Error Response :

<error_response xmlns="<http://api.friendster.com/v1/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://api.friendster.com/v1/">
    <error_code>104</error_code>
    <error_msg>Invalid signature</error_msg>
</error_response>

Destroy Current Player Session

Resource URL: https://api.friendster.com/v1/sessions/destroy

Resource Methods: POST (Destroy Session)

Resource Description: API to destroy the current session. The friendster system will issue a new session_key when the user tries to access your app/game again.

Request :

Response :

Error Conditions/Response :

Example Request :

 http://api.friendster.com/v1/sessions/destroy?
 api_key=2e37638f335f0545c3719d34f4d20ed0&session_key=M4yZuZ4LjoJQj5BJfT
 kw2HnGw6MG8JyM-57519&sig=fake_sig

Example Response (XML) :

<sessions_response xmlns="https://api.friendster.com/v1/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://api.friendster.com/v1/ https://api.friendster.com/v1/friendster.xsd">
  <status>success</status>
</wallet_response>

Example Error Response :

<error_response xmlns="<https://api.friendster.com/v1/>"
xmlns:xsi="<http://www.w3.org/2001/XMLSchema-instance>"
xsi:schemaLocation="https://api.friendster.com/v1/
https://api.friendster.com/v1/friendster.xsd">
  <error_code>300</error_code>
</error_response>

Get Guild Information

Resource URL: http://api.friendster.com/v1/guilds/<GID> or http://api.friendster.com/v1/guilds?gid=<GIDS>

Resource Methods: GET (Retrieval of guild information) : POST (Retrieval of guild information)

Resource Description: API to get information on one or more guilds. If no guild_id is specified, information about current logged in avatars' guild will be returned.

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/guilds/57519?
    api_key=2e37638f335f0545c3719d34f4d20ed0&
    session_key=M4yZuZ4LjoJQj5BJfTkw2HnGw6MG8JyM-57519&
    nonce=326233766.3425&
    sig=012345678901234567890123456789012

http://api.friendster.com/v1/guilds?gid=57519&
    api_key=2e37638f335f0545c3719d34f4d20ed0&
    session_key=M4yZuZ4LjoJQj5BJfTkw2HnGw6MG8JyM-57519&
    nonce=326233766.3425&
    sig=012345678901234567890123456789012

Example Response (XML) :

<?xml version="1.0" encoding="UTF-8" ?>
<guild_response xmlns="http://api.friendster.com/v1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://api.friendster.com/v1/friendster.xsd">
    <guild>
        <gid>635423412</uid>
        <name><![CDATA[Senior]]></name>
        <description><![CDATA[Senior Guild]]></description>
        <logo>http://photos.friendster.com:81/photos/43/09/45345/1_620223562m.jpg</logo>
    </user>
</guild_response>

Example Error Response :

<error_response xmlns="<http://api.friendster.com/v1/>"
    xmlns:xsi="<http://www.w3.org/2001/XMLSchema-instance>"
xsi:schemaLocation="http://api.friendster.com/v1/
http://api.friendster.com/v1/friendster.xsd">
<error_code>7</error_code>
<error_msg>Unauthorized source IP address (ip was: 10.1.2.3)</error_msg>
</error_response>

Application Guilds

Resource URL :http://api.friendster.com/v1/application_guilds

Resource Method : GET (Get list of guilds for the game)

Resource Description : This API will give a list of guilds that play a specific game. A list of guilds (in the form of their guild IDs) will be returned. All guilds that were created, and are associated with a specific game are returned through this request.

Note: Responses will be returned for your game only.

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/points?uid=1234456&points=40

Example Response (XML) :

<?xml version="1.0" encoding="UTF-8"?>
<application_guilds_response xmlns="http://api.friendster.com/v1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://api.friendster.com/v1/ http://api.friendster.com/v1/friendster.xsd">
  <app>c1793215830056bd3250e704c087e65d</app>
  <guilds length="1">
    <guild>26</guild>
  </guilds>
</application_guilds_response>

Example Error Response :

<error_response xmlns="<http://api.friendster.com/v1/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://api.friendster.com/v1/">
    <error_code>104</error_code>
    <error_msg>Invalid signature</error_msg>
</error_response>

Post a rich message to the current users' wall'

Resource URL:

http://api.friendster.com/v1/wall

Resource Method: POST (generate a rich wall post)

Resource Description: API to post a rich message to the users' wall. A rich message can contain images, formatted text and various interactive elements and is defined using SFML (simple friendster markup language) SFML Reference

Request:

Response :

Error Conditions/Response :

Example Request:

http://api.friendster.com/v1/wall?template=<fb:me/>&subject=wall post&label=click

Example Response (XML):

<?xml version="1.0" encoding="UTF-8"?>
<wall_response xmlns="http://api.friendster.com/v1/" xmlns:xsi="
http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://api.friendster.com/v1/ http://api.friendster.com/v1/friendster.xsd">
  <id>1845</id>
  <created_at>1342683525</created_at>
</wall_response>

Example Error Response (XML):

<?xml version="1.0" encoding="UTF-8"?>
<error_response>
  <error_code>71</error_code>
  <error_msg>Invalid Template format [["line 1 column 20: start tag [fb:me] does not match tag [a]"]]</error_msg>
</error_response>

Post Assets

Resource URL :http://api.friendster.com/v1/assets

Resource Method : POST (Upload an asset for the current publisher)

Resource Description : This API uploads an asset resource for the current publisher. This asset is accessible by any of the publishers games. Assets are used by various APIs (e.g. /v1/ wall) in order to display images and other resources.

Request :

Response :

Error Conditions/Response :

Example Request :

http://api.friendster.com/v1/wall
::Content-Type: multipart/form-data; boundary=xxx
MIME-version: 1.0

--xxx
Content-Disposition: form-data; name="content"

Traveling to Vegas!

Example Response (XML) :

<?xml version="1.0" encoding="UTF-8"?>
<asset_response xmlns="http://api.friendster.com/v1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://api.friendster.com/v1/ http://api.friendster.com/v1/friendster.xsd">
  <asset_serial>main_event_icon</asset_serial>
  <url>http://smackaho.st:3333/system/publisher_assets/image_assets/15/thumb_1343617066.png</url>
  <checksum>a0b413865ecacfcac327c9d7ead0aaf778f5d7ea</checksum>
</asset_response>

Example Error Response :

<error_response xmlns="<http://api.friendster.com/v1/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://api.friendster.com/v1/">
    <error_code>104</error_code>
    <error_msg>Invalid signature</error_msg>
</error_response>

Get Random Players

Resource URL:

http://api.friendster.com/v1/players

Resource Method:

GET (obtain a random list of players who have the game currently installed)

Resource Description:

This API returns a random list of players who have the game currently installed

Request :

Response :

Error Conditions/Response :

Example Request:

http://api.friendster.com/v1/application/friends

Example Response (XML):

<players_response xmlns="http://api.friendster.com/v1/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://api.friendster.com/v1/friendster.xsd" list="true">
    <players>
      <uid>123456</uid>
      <uid>81213123</uid>
      <uid>12310993</uid>
    </players>
</players_response>

Example Error Response

<error_response xmlns="http://api.friendster.com/v1/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://api.friendster.com/v1/">
<error_code>104</error_code>
<error_message>Invalid signature</error_message>
</error_response>

Wallet API

The wallet APIs allow developers to access the wallet in order to facilitate the purchase of virtual goods and/or services within your game. The Wallet API is available to both premium and non-premium apps, however your app must have been upgraded to premium status in order to gain access to the real wallet otherwise your app will be limited to "sandbox" mode. Developers can use sandbox mode in order to prepare their app before they request for premium status.

The Friendster payment API flow

The Friendster payment API flow is designed so that the customer’s password is not passed to the game. It allows the user to approve all transactions to his or her wallet.

A purchase is performed using the following steps:

• App obtains a request token using the GET PAYMENT REQUEST (https:// {api_domain}/v1/wallet/payment) call. The app will need to supply all the purchase details including the amount, product name, description etc. The request token will be needed in the succeeding steps.
• The App will be required to redirect the user to the Payments Authentication page. The URL to the payments authentication page is returned in the response of the https:// {api_domain}/v1/wallet/payment call. The behavior of the payments authentication page is described in the "PAYMENTS AUTHENTICATION PAGE" section.
• The User must then enter his or her password in the Payments Authentication page. While the App has no control on the behavior of this page, if a return_url is provided, the user will be redirected back to the app after the user has been successfully authenticated. Additionally if your app has defined a wallet callback url in the app settings, a background call will also be initiated to notify your app of the transaction.
• After control is returned to the App via the redirect and/or the wallet callback url, assuming the authentication process is successful the next step is for the App to issue the COMMIT PAYMENT REQUEST (https:// {api_domain}/v1/wallet/commit). At this point, the balance of the user is deducted and the App may now deliver the product purchased by the user. The transaction commit is successful if and only if there is a successful response and a transaction id is returned. For accounting purposes the App is advised to store the corresponding transaction id returned by this call. Please note that for non-sandbox mode, there will be a corresponding entry in the users’ wallet transaction history.

How the Sandbox environment works

The Wallet API provides a sandbox environment where the game developer can use a fake wallet and coins balance in order to perform integration testing. Each game has its own sandbox, which means that two different games will transact against distinct wallets. If a game developer manages two games, the game developer will have separate balances for each sandbox. Also, a distinctive chrome is displayed around your game's iframe indicating sandbox mode.

For premium apps you can access sandbox mode by clicking on the “play in sandbox” link (non-premium or normal apps will always use the sandbox wallet). A flag “sandbox=true” will be passed to your app via the iframe if the current session is using sandbox mode. The app should use this flag to prevent confusion during billing, as transactions performed against sandbox mode is not valid. Sandbox mode is only accessible by the developer and admin. The sandbox and production wallets are distinct. When a game is not played in sandbox mode, it will access the wallet the current user has created.

The sandbox wallet is automatically created upon the first use of the game in its sandbox environment. The initial balance for each new sandbox wallet is 1000000 coins.