метод REST scope: im

im.department.get

Получить информацию о подразделении

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

Описание

Метод im.department.get получает данные о подразделениях по их идентификаторам ID.

Параметры

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.get

Ответ

HTTP-статус: 200

{
    "result": [
        {
            "id": 7,
            "name": "Отдел разработки",
            "full_name": "Отдел разработки / mysite.ru",
            "manager_user_id": 103
        },
        {
            "id": 3,
            "name": "Финансовый отдел",
            "full_name": "Финансовый отдел / mysite.ru",
            "manager_user_id": 13
        }
    ],
    "time": {
        "start": 1772527966,
        "finish": 1772527966.081649,
        "duration": 0.0816490650177002,
        "processing": 0,
        "date_start": "2026-03-03T11:52:46+03:00",
        "date_finish": "2026-03-03T11:52:46+03:00",
        "operating_reset_at": 1772528566,
        "operating": 0
    }
}

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

result array

Список подразделений (подробное описание).

При USER_DATA = 'N' содержит краткое описание подразделений, при USER_DATA = 'Y' дополнительно содержит объект с данными о руководителе подразделения

time time

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

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

HTTP-статус: 400

{
    "error": "INVALID_FORMAT",
    "error_description": "A wrong format for the ID field is passed"
}
Код Описание Значение
400 INVALID_FORMAT A wrong format for the ID field is passed
403 ACCESS_ERROR Only intranet users have access to this method

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

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