Просмотров: 14667
Дата последнего изменения: 17.10.2024
Александр Суворов
Сложность урока:
3 уровень - средняя сложность. Необходимо внимание и немного подумать.
1
2
3
4
5
Получение списка сотрудников в подразделении
Ревизия
Получить информацию о текущей ревизии API (версии платформы) – im.revision.get
: 18
Обратите внимание! Метод указан с использованием функции restCommand - это метод отправки данных в Битрикс24, данный метод есть в примере ЭхоБота, и представлен здесь в качестве примера. Вы можете использовать свою функцию или javascript-метод BX24.callMethod или bitrix24-php-sdk.
Примечание: Метод im.department.employees.get доступен только для
интранет-пользователей
В Битрикс24 различают два вида пользователей:
интранет-пользователи – внутренние пользователи (сотрудники Вашей компании);
экстранет-пользователи – внешние пользователи (поставщики, дистрибьюторы и т.п.).
connector – признак пользователя открытых линий (true/false)
external_auth_id – код внешней авторизации
status – статус пользователя. Всегда отображается как online, даже если пользователь установил статус «Не беспокоить». Статус «Не беспокоить» влияет только на получение уведомлений и не виден другим пользователям
idle – дата, когда пользователь отошел от компьютера, в формате АТОМ (если не задано, false)
last_activity_date – дата последнего действия пользователя в формате АТОМ
mobile_last_date – дата последнего действия в мобильном приложении в формате АТОМ (если не задано, false)
desktop_last_date – дата последнего действия в десктопном приложении в формате АТОМ (если не задано, false)
absent – дата, по какое число у пользователя отпуск, в формате АТОМ (если не задано, false)
phones – массив номеров телефонов: work_phone – рабочий телефон, personal_mobile – мобильный телефон, personal_phone – домашний телефон
Пример ответа при возникновении ошибки
{
"error": "ID_EMPTY",
"error_description": "Department ID can't be empty"
}
Описание ключей:
error – код возникшей ошибки
error_description – краткое описание возникшей ошибки