MyChat Integration API: MCIAPI_CS_IsUINOnline, дізнатися, чи користувач онлайн
З'ясувати, онлайн вказаний користувач чи ні за його унікальним числовим ідентифікатором (UIN).
Синтаксис
{
"cmd" : "0003",
"ServerKey" : "iddqd",
"APIStype" : "mydata",
"context" : "myfunc",
"UIN" : 18
}
Якщо "UserFrom" і "UserTo" будуть збігатися (ви намагаєтеся надіслати повідомлення самому собі), то замість відправника буде автоматично підставлений UIN=0 (вбудований робот).
Параметри
|
Параметр |
Тип |
Значення |
|
cmd |
string |
"0003", номер команди MCIAPI_CS_IsUINOnline; |
|
ServerKey |
string |
ключ Integration API, задається у налаштуваннях сервера; |
|
APIStype |
string |
тип інтеграції. Можна задавати довільний рядок; |
|
context |
string |
необов'язковий параметр, будь-який текст, що повернеться у команді-відповіді; |
|
UIN |
integer |
числовий ідентифікатор користувача, повинен бути зареєстрований на сервері. |
Результат роботи
{
"cmd" : "0003",
"context" : "myfunc",
"UIN" : 18,
"Online" : true
}
|
Поле |
Тип |
Значення |
|
cmd |
string |
HEX-номер команди, що була успішно виконана; |
|
context |
string |
довільний текст, що буде переданий серверу в команді запиту; |
|
UIN |
integer |
унікальний ідентифікатор користувача; |
|
Online |
boolean |
true — якщо користувач в мережі, false — відключений від сервера. |
Можливі помилки
#5, MCIAPI_Error_WrongIntegrationKey
#10, MCIAPI_Error_ParameterAbsent