MyChat Integration API: MCIAPI_CS_GetUserInfoByUIN, отримати властивості облікового запису користувача за його UIN
Отримати властивості облікового запису користувача за його UIN.
Синтаксис
{
"cmd" : "000D",
"ServerKey" : "iddqd",
"APIStype" : "mydata",
"context" : "myfunc",
"UIN" : 6,
"What" : "AuthType,DomainName,Nick,DisplayName,Email,Active,FirstName,MiddleName,LastName,BirthdayISO,Sex"
}
Параметри
|
Параметр |
Тип |
Значення |
|
cmd |
string |
"0006", номер команди MCIAPI_CS_GetUINByEmail; |
|
ServerKey |
string |
ключ Integration API, задається у налаштуваннях сервера; |
|
APIStype |
string |
тип інтеграції. Можна задавати довільний рядок; |
|
context |
string |
необов'язковий параметр, будь-який текст, що повернеться у команді-відповіді; |
|
UIN |
integer |
ідентифікатор облікового запису користувача, число більше нуля; |
|
What |
string |
які дані потрібно отримати про користувача, параметри через кому. Якщо нічого не вказати або вказати "all", то функція поверне всі дані, що є. Параметри у відповіді завжди будуть "camel case", але у вихідному запиті можна використовувати будь-який регістр літер. Між комами в тексті параметра не повинно бути пробілів. |
Список доступних полів користувача у параметрі "What"
|
Назва |
Тип |
Опис |
|
Avatar |
integer |
CRC32 фотографії користувача; |
|
Tag |
string |
текстовий тег, спеціальне поле, можна змінювати та читати через MSL; |
|
DomainName |
string |
ім'я домену користувача; |
|
Nick |
string |
нік користувача. Якщо користувач доменний — це його доменне ім'я; |
|
DisplayName |
string |
ім'я користувача, що відображається у інтерфейсі. Стиль налаштовується на сервері; |
|
Active |
boolean |
активний чи заблокований обліковий запис користувача; |
|
FirstName |
string |
реальне ім'я користувача; |
|
MiddleName |
string |
по-батькові користувача; |
|
LastName |
string |
прізвище користувача; |
|
Registered |
double |
дата і час створення облікового запису; |
|
Role |
integer |
роль користувача (номер групи прав); |
|
RoleName |
string |
назва групи прав користувача; |
|
MaritalStatus |
integer |
сімейний стан: -1 — не вказано; 0 — у серйозних відносинах; 1 — вдівець/вдова; 2 — одружений/заміжня; 3 — заручений(а) 4 — розлучений(а); 5 — розійшлись; 6 — холостяк/незаміжня; |
|
HomePhone |
string |
домашній телефон; |
|
HomeFax |
string |
домашній факс; |
|
Birthday |
double |
дата народження; |
|
BirthdayISO |
string |
дата народження у форматі ISO 8601 (yyyy-mm-dd); |
|
|
string |
основна адреса електронної пошти; |
|
HomeCellular |
string |
особистий мобільний; |
|
HomeStreetAddress |
string |
домашня адреса; |
|
HomeCity |
string |
місто проживання; |
|
HomeState |
string |
штат/провінція/область/край проживання; |
|
HomeZIP |
string |
домашня поштова адреса; |
|
HomeCountry |
integer |
країна проживання; |
|
HomeWWW |
string |
особиста WEB-сторінка; |
|
WorkDept |
string |
робочий підрозділ; |
|
WorkDeptIdx |
integer |
внутрішній індекс робочого підрозділу (число); |
|
WorkPosition |
string |
посада; |
|
WorkPositionIdx |
integer |
внутрішній індекс посади (число); |
|
WorkCompanyName |
string |
назва компанії; |
|
WorkOffice |
string |
робочий офіс; |
|
WorkPhone |
string |
робочий телефон; |
|
WorkFax |
string |
робочий факс; |
|
WorkPager |
string |
робочий пейджер або номер месенджера; |
|
WorkStreetAddress |
string |
робоча адреса; |
|
WorkCity |
string |
робоче місто; |
|
WorkState |
string |
робочий штат/провінція/область/край; |
|
WorkZIP |
string |
робочий поштовий індекс; |
|
WorkCountry |
integer |
робоча країна; |
|
WorkWWW |
string |
робоча WEB-сторінка; |
|
SpokenLang1 |
integer |
володіння мовами, номер 1; |
|
SpokenLang2 |
integer |
, номер 2; |
|
SpokenLang3 |
integer |
володіння мовами, номер 3; |
|
Interests1 |
integer |
область інтересів, номер 1; |
|
InterestsWords1 |
string |
область інтересів, ключові слова, номер 1; |
|
Interests2 |
integer |
область інтересів, номер 2; |
|
InterestsWords2 |
string |
область інтересів, ключові слова, номер 2; |
|
Interests3 |
integer |
область інтересів, номер 3; |
|
InterestsWords3 |
string |
область інтересів, ключові слова, номер 3; |
|
Interests4 |
integer |
область інтересів, номер 4; |
|
InterestsWords4 |
string |
область інтересів, ключові слова, номер 4; |
|
Past1 |
integer |
тип минулого місця роботи або навчання, номер 1; |
|
PastWords1 |
string |
тип минулого місця роботи чи навчання, ключові слова номер 1; |
|
Past2 |
integer |
тип минулого місця роботи чи навчання, номер 2; |
|
PastWords2 |
string |
тип минулого місця роботи чи навчання, ключові слова номер 2; |
|
Past3 |
integer |
тип минулого місця роботи чи навчання, номер 3; |
|
PastWords3 |
string |
тип минулого місця роботи чи навчання, ключові слова номер 3; |
|
PastOrg1 |
integer |
тип організації, минулого місця роботи, номер 1; |
|
PastOrgWords1 |
string |
тип організації, минулого місця роботи, ключові слова номер 1; |
|
PastOrg2 |
integer |
тип організації, минулого місця роботи, номер 2; |
|
PastOrgWords2 |
string |
тип організації, минулого місця роботи, ключові слова номер 2; |
|
PastOrg3 |
integer |
тип організації, минулого місця роботи, номер 3; |
|
PastOrgWords3 |
string |
тип організації, минулого місця роботи, ключові слова номер 3; |
|
Sex |
integer |
стать користувача: 0 — не визначено, 1 — чоловічий, 2 — жіночий; |
|
AuthType |
integer |
тип автентифікації клієнта: 0 — стандартний, 1 — Active Directory, 2 — без пароля, 3 — Transparent AD; |
|
LastAccess |
double |
дата та час останнього доступу до сервера; |
|
LastSpeakTime |
double |
дата та час останнього відправленого повідомлення; |
|
State |
integer |
поточний мережевий статус користувача; |
|
FavoriteChannelsExists |
boolean |
чи є у користувача список "улюблених" текстових конференцій; |
|
UnreadedBroadcastsExists |
boolean |
наявність непрочитаних оповіщень; |
|
HelloMessage |
string |
повідомлення-привітання, якщо є. Показується усім користувачам, які відкрили приват з цією людиною; |
|
AutoreplayMessage |
string |
повідомлення-автовідповідач; |
|
Autoreplay |
boolean |
чи увімкнений автовідповідач; |
|
Reputation |
integer |
репутація користувача, число; |
|
About |
string |
інформаційне поле "Про користувача". |
Приклад GET-запиту в адресному рядку для браузера
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"}
Результат роботи
{
"cmd" : "000D",
"UIN" : 17,
"What" : "AuthType,DomainName,Nick,DisplayName,Email,Active,FirstName,MiddleName,LastName,BirthdayISO,Sex",
"context" : "myfunc",
"AuthType" : 0,
"DomainName" : "",
"Nick" : "johnronaldreueltolkien",
"DisplayName" : "John Ronald Tolkien",
"Email" : "[email protected]",
"Active" : true,
"FirstName" : "John",
"MiddleName" : "Ronald Reuel",
"LastName" : "Tolkien",
"BirthdayISO" : "1973-09-02",
"Sex" : 1
}
|
Поле |
Тип |
Значення |
|
cmd |
string |
HEX-номер команди, яка була успішно виконана; |
|
context |
string |
довільний текст, що був переданий серверу в команді запиту; |
|
UIN |
integer |
унікальний ідентифікатор користувача, інформація про якого було запитано; |
|
What |
string |
параметри через кому, що присутні в даному JSON-об'єкті. |
Можливі помилки
#5, MCIAPI_Error_WrongIntegrationKey
#24, MCIAPI_Error_UINIsNotDefined
#28, MCIAPI_Error_CannotWorkWithRobot