метод REST scope: im

im.department.managers.get

Получить список руководителей подразделений

Кто может выполнять: любой интранет-пользователь, кроме ботов

Описание

Метод im.department.managers.get получает список руководителей указанных подразделений.

Параметры

ID array обязательный

Массив идентификаторов подразделений. Можно передать строку с JSON-массивом идентификаторов.

Получить идентификатор подразделения можно методом получения списка подразделений или методом поиска подразделений по названию

USER_DATA string необязательный

Возвращать подробные данные пользователей.

Возможные значения:
- Y — да
- N — нет

По умолчанию: N

Примеры запроса

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"ID":[3,7],"USER_DATA":"Y"}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.department.managers.get

Ответ

HTTP-статус: 200

{
    "result": {
        "3": [13],
        "7": [103]
    },
    "time": {
        "start": 1772519172,
        "finish": 1772519172.208348,
        "duration": 0.20834803581237793,
        "processing": 0,
        "date_start": "2026-03-03T09:26:12+03:00",
        "date_finish": "2026-03-03T09:26:12+03:00",
        "operating_reset_at": 1772519772,
        "operating": 0
    }
}

Возвращаемые данные

result object

Корневой объект, где ключ — идентификатор подразделения, значение:
- при USER_DATA = 'N' содержит массив идентификаторов руководителей,
- при USER_DATA = 'Y' содержит массив объектов с описанием пользователей — руководителей подразделения (подробное описание)

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "ID_EMPTY",
    "error_description": "Department ID can't be empty"
}
Код Описание Значение
400 ID_EMPTY Department ID can't be empty
403 ACCESS_ERROR Only intranet users have access to this method

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.