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 |
тип интеграции. Можно задавать произвольную строку; |
context |
string |
необязательный параметр, любой текст, который вернётся в ответной команде; |
UINS |
string |
список числовых идентификаторов пользователей, статус которых нужно получить. |
Результат работы
{
"cmd" : "000F",
"context" : "myfunc",
"UINS" : "17,13,18,99,165",
"Statuses" : "-1,-1,0,1,2"
}
Поле |
Тип |
Значение |
cmd |
string |
HEX-номер команды, которая была успешно выполнена; |
context |
string |
произвольный текст, который был передан серверу в команде запроса; |
UINS |
string |
список числовых идентификаторов пользователей, через запятую; |
Statuses |
string |
список статусов пользователей, через запятую. Если в списке UIN-ов пользователей есть несуществующие идентификаторы, то сервер вернёт для них "-1", т.е. офлайн. |
Возможные ошибки
#5, MCIAPI_Error_WrongIntegrationKey
#9, MCIAPI_Error_API_Disabled
#21, MCIAPI_Error_WrongData
#25, MCIAPI_Error_UINSIsNotDefined
#26. MCIAPI_Error_WrongUINSList