MyChat Integration API: MCIAPI_CS_GetUsersStatusList, отримати список статусів користувачів
Отримати список статусів (онлайн, офлайн, зайнятий, немає на місці) для зазначеного списку користувачів.
Синтаксис
{
"cmd" : "000F",
"ServerKey" : "iddqd",
"APIStype" : "mydata",
"context" : "myfunc",
"UINS" : "17,13,18,99,165"
}
Параметри
Параметр |
Тип |
Значення |
cmd |
string |
"000F", номер команди MCIAPI_CS_GetUsersStatusList; |
ServerKey |
string |
ключ Integration API, задається у налаштуваннях сервера; |
APIStype |
string |
тип інтеграції. Можна задавати довільний рядок; |
UINS |
string |
список числових ідентифікаторів користувачів, статус яких необхідно отримати. |
Результат роботи
{
"cmd" : "000F",
"context" : "myfunc",
"UINS" : "17,13,18,99,165",
"Statuses" : "-1,-1,0,1,2"
}
Поле |
Тип |
Значення |
Cmd |
integer |
номер команди, що була успішно виконана, рівно 15 (HEX 000F); |
UINS |
string |
список числових ідентифікаторів користувачів, через кому; |
Statuses |
string |
список статусів користувачів, через кому. Якщо у списку UIN-ів користувачів є неіснуючі ідентифікатори, то сервер поверне для них "-1", тобто. офлайн. |
Можливі помилки
#5, MCIAPI_Error_WrongIntegrationKey
#25, MCIAPI_Error_UINSIsNotDefined
#26. MCIAPI_Error_WrongUINSList