MyChat Integration API: MCIAPI_CS_GetUINByNick отримати UIN користувача за ніком
Функція для отримання унікального числового ідентифікатора (UIN) зареєстрованого користувача за ним.
Нік чи логін – це спеціальне ім'я користувача, під яким він може увійти до чату. Якщо це доменний користувач, то потрібно вказати спочатку домен через зворотний слеш, ось так: "domain\login".
Якщо на сервері відключено заборону на дублювання ніків, ви шукаєте звичайного, не доменного користувача, і ніки у вас повторюються, то система знайде перший-ліпший нік. Враховуйте цей момент.
Регістр букв не важливий, "JohnSmith" та "johnsmith" вважаються однаковими ніками.
Синтаксис
{
"cmd" : "0005",
"ServerKey" : "iddqd",
"APIStype" : "mydata",
"context" : "myfunc",
"Nick" : "JohnSmith"
}
Параметри
|
Параметр |
Тип |
Значення |
|
cmd |
string |
"0005", номер команди MCIAPI_CS_GetUINByNick; |
|
ServerKey |
string |
ключ Integration API, задається у налаштуваннях сервера; |
|
APIStype |
string |
тип інтеграції. Можна задавати довільний рядок; |
|
context |
string |
необов'язковий параметр, будь-який текст, що повернеться у команді-відповіді; |
|
Nick |
string |
нік користувача, обов'язкове унікальне текстове поле; |
Результат роботи
{
"cmd" : "0005",
"сontext" : "myfunc",
"UIN" : 17
}
|
Поле |
Тип |
Значення |
|
cmd |
string |
HEX-номер команди, що була успішно виконана; |
|
context |
string |
довільний текст, що був переданий серверу в команді запиту; |
|
UIN |
integer |
унікальний ідентифікатор знайденого користувача (UIN). |
Можливі помилки
#5, MCIAPI_Error_WrongIntegrationKey
#9, MCIAPI_Error_API_Disabled
#10, MCIAPI_Error_ParameterAbsent
#18, MCIAPI_Error_NickCannotBeEmpty
#43, MCIAPI_Error_UnknownDomainUser