MyChat Integration API: MCIAPI_CS_GetUsersStatusList, получить список статусов пользователей

MyChat Integration API: MCIAPI_CS_GetUsersStatusList, получить список статусов пользователей

Получить список статусов (онлайн, офлайн, занят, нет на месте) для указанного списка пользователей.

 

Синтаксис

{

 "cmd"        : "000F",

 "ServerKey"  : "iddqd",

 "APIStype"   : "mydata",

 

 "UINS"       : "17,13,18,99,165"

}

 

Параметры

Параметр

Тип

Значение

cmd

string

"000F", номер команды MCIAPI_CS_GetUsersStatusList;

ServerKey

string

ключ Integration API, задаётся в настройках сервера;

APIStype

string

тип интеграции. Можно задавать произвольную строку;

UINS

string

список числовых идентификаторов пользователей, статус которых нужно получить.

 

Результат работы

{

 "cmd"      : "000F",

 "UINS"     : "17,13,18,99,165"

 "Statuses" : "-1,-1,0,1,2"

}

 

Поле

Тип

Значение

Cmd

integer

номер команды, которая была успешно выполнена, равно 15 (HEX 000F);

UINS

string

список числовых идентификаторов пользователей, через запятую;

Statuses

string

список статусов пользователей, через запятую. Если в списке UIN-ов пользователей есть несуществующие идентификаторы, то сервер вернёт для них "-1", т.е. офлайн.

 

Возможные ошибки

MCIAPI_Error_UINSIsNotDefined

MCIAPI_Error_WrongIntegrationKey

MCIAPI_Error_WrongUINSList

 

Ещё посмотреть

MCIAPI_CS_GetUINByNick