API Methods
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).
