Get a list of statuses (online, offline, do not disturb, away) for a specified list of users.

 

Syntax
{
 "cmd"        : "000F",
 "ServerKey"  : "iddqd",
 "APIStype"   : "mydata",

 "context"    : "myfunc",
 
 "UINS"       : "17,13,18,99,165"
}


Parameters

Parameter

Type

Value

cmd

string

"000F", number of the command MCIAPI_CS_GetUsersStatusList;

ServerKey

string

IntegrationAPI key, can be set in the server settings;

APIStype

string

integration type. You can set any string;

context

string

optional parameter, any text that returns in response command;

UINs

string

list of user numeric identifiers which status you need to obtain.

 

Work result

{
  "cmd"      : "000F",
  "context"  : "myfunc",
  "UINS"     : "17,13,18,99,165",
  "Statuses" : "-1,-1,0,1,2"
}


Field

Type

Value

Cmd

integer

number of a command that was successfully executed, equal to 15 (HEX 000F);

context

string

any text sent to the server in a query command;

UINs

string

list of user numeric identifiers divided by commas;

Statuses

string

list of user statuses divided by commas. If non-existent identifiers are present in the user UIN list, then the server returns the "-1" value for them (offline).

 

Possible errors

#5, MCIAPI_Error_WrongIntegrationKey

#9, MCIAPI_Error_API_Disabled

#21, MCIAPI_Error_WrongData

#25, MCIAPI_Error_UINSIsNotDefined

#26. MCIAPI_Error_WrongUINSList

 

See also

MCIAPI_CS_GetUINByNick