Get account properties by their UIN.


Syntax


{
 "cmd"        : "000D",
 "ServerKey"  : "iddqd",
 "APIStype"   : "mydata",
 
 "UIN"  : 6,
 "What" : "AuthType,DomainName,Nick,DisplayName,Email,Active,FirstName,MiddleName,LastName,BirthdayISO,Sex"
}


Parameters

Parameter

Type

Value

cmd

string

"000FD", MCIAPI_CS_GetUserInfoByUIN command number;

ServerKey

string

Integration API key (set in the server's settings);

APIStype

string

integration type. Specify any string;

UIN

integer

user account ID, a number grater than 0;

What

string

what data is required; parameters separated by commas. If nothing or "all" is specified, then a function returns all data available. As a result, parameters are always "camel case", but you can use any letter case in the initial request. No spaces between commas in the parameter text.



List of available parameters


Name

Type

Description

Avatar

integer

CRC32 of the user's photo;

Tag

string

text tag, special field, can be edited and read via MSL;

DomainName

string

user's domain name;

Nick

string

user's nickname. If it is a domain user then it is his domain name;

DisplayName

string

user's display name. The style is configured on the server;

Active

boolean

active or blocked user's account;

FirstName

string

user's real name;

MiddleName

string

user's middle name;

LastName

string

user's last name;

Registered

double

date and time of the account creation;

Role

integer

user's role (the number of the rights group);

RoleName

string

name of the user's rights group;

MaritalStatus

integer

marital status:

-1— — unspecified;

0 —— in a relationship;

1 — widowed;

2 — married;

3 — engaged;

4 — divorced;

5 — separated;

6 — unmarried;

HomePhone

string

home phone number;

HomeFax

string

home fax;

Birthday

double

date of birth;

BirthdayISO

string

birth day in the format ISO 8601 (yyy-mm-dd)

Email

string

main email address;

HomeCellular

string

personal mobile phone;

HomeStreetAddress

string

home address;

HomeCity

string

home city;

HomeState

string

state/province/region/district;

HomeZIP

string

home ZIP code;

HomeCountry

integer

home country;

HomeWWW

string

personal WEB page;

WorkDept

string

work department;

WorkDeptIdx

integer

internal index of the work department (number);

WorkPosition

string

work position;

WorkPositionIdx

integer

internal index of the work position (number);

WorkCompanyName

string

company name;

WorkOffice

string

work office;

WorkPhone

string

work phone number;

WorkFax

string

work fax;

WorkPager

string

work pager or messenger number;

WorkStreetAddress

string

work address;

WorkCity

string

work city;

WorkState

string

work state/province/region/district;

WorkZIP

string

work ZIP code;

WorkCountry

integer

work country;

WorkWWW

string

work WEB page;

SpokenLang1

integer

language spoken, number 1;

SpokenLang2

integer

language spoken, number 2;

SpokenLang3

integer

language spoken, number3;

Interests1

integer

interests section, number 1;

InterestsWords1

string

interests section, key words, number 1;

Interests2

integer

interests section, number 2;

InterestsWords2

string

interests section, key words, number 2;

Interests3

integer

interests section, number 3;

InterestsWords3

string

interests section, key words, number 3;

Interests4

integer

interests section, number 4;

InterestsWords4

string

interests section, key words, number 4;

Past1

integer

type of former employment or study, number 1;

PastWords1

string

type of former employment or study, key words number 1;

Past2

integer

type of former employment or study, number 2;

PastWords2

string

type of former employment or study, key words number 2;

Past3

integer

type of former employment or study, number 3;

PastWords3

string

type of former employment or study, key words number 3;

PastOrg1

integer

organization type, former employment, number 1;

PastOrgWords1

string

organization type, former employment, key words number 1;

PastOrg2

integer

organization type, former employment, number 2;

PastOrgWords2

string

organization type, former employment, key words number 2;

PastOrg3

integer

organization type, former employment, number 3;

PastOrgWords3

string

organization type, former employment, key words number 3;

Sex

integer

user's gender: 0 — unspecified, 1 — male, 2 — female;

AuthType

integer

type of client authentication: 0 — default, 1 — Active Directory, 2 — without a password, 3 — Transparent AD;

FotoCRC32

integer

user's CRC32 photos;

LastAccess

double

date and time of the last access to the server;

LastSpeakTime

double

date and time of the last sent message;

State

integer

current user's network status;

FavoriteChannelsExists

boolean

check user's list of favorite text conferences;

UnreadedBroadcastsExists

boolean

availability of unread notifications;

OfflineMessagesExists

boolean

availability of the offline messages that were not received;

HelloMessage

string

greeting message, if available. Displays to all users, who opened the private chat with this person;

AutoreplayMessage

string

auto-reply message;

Autoreplay

boolean

enabled or disabled answerphone;

Reputation

integer

user's reputation, number;

About

string

information field "About user";


The example of the GET request in the browser address bar

http://192.168.10.1:8080/API/?data={"cmd":"000D","APIStype":"mydata","ServerKey":"iddqd","UIN":17,"What":"AuthType,DomainName,Nick,DisplayName,Email,Active,FirstName,MiddleName,LastName,BirthdayISO,Sex"}


Work result
{
 "cmd"  : "000D",
 "UIN"  : 17,
 "What" : "AuthType,DomainName,Nick,DisplayName,Email,Active,FirstName,MiddleName,LastName,BirthdayISO,Sex",

 "AuthType"    : 0,
 "DomainName"  : "",
 "Nick"        : "johnronaldreueltolkien",
 "DisplayName" : "John Ronald Tolkien",
 "Email"       : "j.r.r.tolkien@themiddleearth.com",
 "Active"      : true,
 "FirstName"   : "John",
 "MiddleName"  : "Ronald Reuel",
 "LastName"    : "Tolkien",
 "BirthdayISO" : "1973-09-02",
 "Sex" : 1
}


Parameter

Type

Value

cmd

string

HEX number of successfully executed command;

UIN

integer

user's unique identifier;

What

string

parameters of JSON object separated by commas.


Possible errors
#5, MCIAPI_Error_WrongIntegrationKey

#20, MCIAPI_Error_EmailNotFound

#23: MCIAPI_Error_EmailIsNotDefined


See also

0005: MCIAPI_CS_GetUINByNick