3jam.user.setPreferences

Set a 3jam user's preferences. getPreferences is used to get preferences.

Authentication

Authentication with a 3jam user's mobile phone number and password is required

Arguments

api_key (required)

api_version (required)

mobile (required)

Mobile number of 3jam user you're requesting friends for

password (required)

md5 the concatenation of the mobile number and 3jam password for this user. e.g. in PHP: md5($mobile . $password)

firstname (optional)

First name to set for this user

lastname (optional)

Last name to set for this user

newAvatarURL (optional)

Avatar (picture) URL

date_of_birth_year (optional)

Birthday year

date_of_birth_month (optional)

Birthday month

date_of_birth_day (optional)

Birthday day

gender (optional)

Gender (male or female)

zipcode (optional)

5-digit Zip Code

Response

<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
  <user user_id="25678" firstname="Charlie" lastname="Brown" />
</rsp>

Error Codes

98: Login failed

The login details or auth token passed were invalid.

100: Invalid API Key

The API key passed was not valid or has expired.

105: Service currently unavailable

The requested service is temporarily unavailable.

601: Invalid first name

The first name provided is invalid (a specific reason will be returned).

602: Invalid last name

The last name provided is invalid (a specific reason will be returned).