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