Views: 5548
Last Modified: 23.03.2022
The method gets list of employees in a department
Revision: 19
Get information on the current API revision (platform version) – im.revision.get.
Parameters
Parameter |
Example |
Req. |
Description |
Revision |
ID |
[105] |
Yes |
Department IDs |
19 |
USER_DATA |
N |
No |
Download user data |
19 |
|
- If the parameter
USER_DATA = Y
, the array of objects with user data is passed in the response instead of IDs array.
Method call
JavaScript
BX24.callMethod('im.department.employees.get', {USER_DATA: 'Y'}, function(result){
if(result.error())
{
console.error(result.error().ex);
}
else
{
console.log('users', result.data());
}
});
PHP
$result = restCommand('im.department.employees.get', Array(
'USER_DATA' => 'Y'
), $_REQUEST["auth"]);
Example of response
With the option USER_DATA = N
:
{
"result": {
105: [1]
}
}
With the option USER_DATA = Y
:
{
"result": {
105: {
"id": 1,
"name": "John Harrington",
"first_name": "John",
"last_name": "Harrington",
"work_position": "",
"color": "#df532d",
"avatar": "http://192.168.2.232/upload/resize_cache/main/1d3/100_100_2/Harrington.png",
"gender": "M",
"birthday": "",
"extranet": false,
"network": false,
"bot": false,
"connector": false,
"external_auth_id": "default",
"status": "online",
"idle": false,
"last_activity_date": "2018-01-29T17:35:31+03:00",
"desktop_last_date": false,
"mobile_last_date": false,
"departments": [
50
],
"absent": false,
"phones": {
"work_phone": "",
"personal_mobile": "",
"personal_phone": ""
}
}
}
}
Description of keys:
id
– user ID
name
– user first and last name
first_name
– user name
last_name
– user last name
work_position
– position
color
– user color in 'hex' format
avatar
– link to avatar (if empty, avatar is not specified)
gender
– user gender
birthday
– user birthday in the DD-MM format, if empty – not specified
extranet
– extranet user attribute (true/false
)
network
– Bitrix24.Network user attribute (true/false
)
bot
– bot attribute (true/false
)
connector
– Open Channel user attribute (true/false
)
external_auth_id
– external authorization code
status
– selected user status
idle
– date, when user is not using his/her PC, in ATOM format (if not specified, false
)
last_activity_date
– date of the last user action, in ATOM format
mobile_last_date
– date of the last action inside mobile app, in ATOM format (if not specified, false
)
desktop_last_date
– date of the action in the desktop app, in ATOM format (if not specified, false
)
absent
– date, to which the user has a leave of absence, in ATOM format (if not specified, false
)
phones
– array of phone numbers: work_phone
– work phone, personal_mobile
– mobile phone, personal_phone
– personal phone number
Example of response when error occurs
{
"error": "ID_EMPTY",
"error_description": "Department ID can't be empty"
}
Description of keys:
error
– error code
error_description
– brief description of error
Possible error codes
Code |
Description |
ID_EMPTY |
ID list not passed |
|
Attention:
restCommand function is used here for illustration purposes only. It is taken from the
EchoBot example. You can send a REST command with your own function, or use the
BX24.callMethod or
bitrix24-php-sdk methods.