метод REST scope: humanresources

humanresources.node.children

Получить дочерние отделы

Кто может выполнять: пользователь с правом «Просмотр отделов» или «Просмотр команд»

Описание

Метод относится к REST 3.0. Особенности вызова и формат ответа новой версии API описаны в обзоре REST 3.0.

Метод humanresources.node.children возвращает прямые дочерние отделы и команды выбранного элемента структуры.

Параметры

id integer обязательный

Идентификатор родительского отдела или команды.

Идентификатор можно получить методом humanresources.node.list

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

Список полей отдела или команды, которые нужно вернуть.

Доступные поля:

  • id — идентификатор элемента структуры
  • name — название отдела или команды
  • type — тип элемента структуры
  • structureId — идентификатор структуры компании
  • parentId — идентификатор родительского отдела или команды
  • description — описание элемента структуры
  • accessCode — код доступа элемента структуры
  • userCount — количество пользователей в отделе или команде
  • colorName — цвет команды
  • xmlId — внешний идентификатор элемента структуры
  • createdAt — дата и время создания
  • updatedAt — дата и время последнего обновления

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":1,"select":["id","name","type","structureId","parentId","description","accessCode","userCount","colorName","xmlId","createdAt","updatedAt"]}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/humanresources.node.children

Ответ

HTTP-статус: 200

{
    "result": {
        "items": [
            {
                "id": 12,
                "name": "Продажи B2B",
                "type": "DEPARTMENT",
                "structureId": 1,
                "parentId": 1,
                "description": "Работа с корпоративными клиентами",
                "accessCode": "DR12",
                "userCount": 9,
                "colorName": null,
                "xmlId": null,
                "createdAt": "2026-05-20T10:15:00+03:00",
                "updatedAt": "2026-06-01T16:30:00+03:00"
            },
            {
                "id": 18,
                "name": "Маркетинг",
                "type": "DEPARTMENT",
                "structureId": 1,
                "parentId": 1,
                "description": "Продвижение продуктов и бренда",
                "accessCode": "DR18",
                "userCount": 6,
                "colorName": null,
                "xmlId": null,
                "createdAt": "2026-05-22T11:40:00+03:00",
                "updatedAt": "2026-06-03T10:05:00+03:00"
            }
        ]
    },
    "time": {
        "start": 1780396400,
        "finish": 1780396400.428761,
        "duration": 0.42876100540161133,
        "processing": 0.3972141742706299,
        "date_start": "2026-06-02T13:33:20+03:00",
        "date_finish": "2026-06-02T13:33:20+03:00",
        "operating_reset_at": 1780397000,
        "operating": 0
    }
}

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

result object

Объект с данными ответа

items array

Массив дочерних отделов и команд. Состав полей элемента зависит от select

time time

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

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

HTTP-статус: 400

{
    "error": {
        "code": "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
        "message": "Ошибка при валидации объекта запроса",
        "validation": [
            {
                "message": "Обязательное поле `id` не указано",
                "field": "id"
            }
        ]
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
id Обязательное поле id не указано Добавьте id в тело запроса
id В поле id требуется тип данных int для такого запроса Убедитесь, что значение id передано числом
select Передано неподдерживаемое имя поля для выборки Используйте только значения из описания параметра select

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

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