Для AI-агентов: markdown этой страницы — /docs-content/humanresources/employees/subordinates.md индекс документации — /llms.txt

Подчинённые сотрудника

GET /v1/humanresources/employees/:id/subordinates

Возвращает подчинённых сотрудника, сгруппированных по узлам организационной структуры, где он назначен руководителем. Для каждого такого узла приходит его название и число подчинённых.

Параметры

Параметр Тип Обяз. Описание
Параметрid (path) Типnumber Обяз.да ОписаниеИдентификатор сотрудника (userId). Поиск: POST /v1/humanresources/employees/search

Примеры

curl — личный ключ

Terminal
curl "https://vibecode.bitrix24.tech/v1/humanresources/employees/1/subordinates" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth-приложение

Terminal
curl "https://vibecode.bitrix24.tech/v1/humanresources/employees/1/subordinates" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — личный ключ

javascript
const res = await fetch('https://vibecode.bitrix24.tech/v1/humanresources/employees/1/subordinates', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

const { success, data } = await res.json()
console.log(`Руководит ${data.departments.length} узлами`)

JavaScript — OAuth-приложение

javascript
const res = await fetch('https://vibecode.bitrix24.tech/v1/humanresources/employees/1/subordinates', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { success, data } = await res.json()

Поля ответа

Поле Тип Описание
Полеsuccess Типboolean ОписаниеВсегда true при успехе
Полеdata.userId Типnumber ОписаниеИдентификатор сотрудника, чьи подчинённые запрошены
Полеdata.departments Типarray ОписаниеУзлы, где сотрудник назначен руководителем. Пустой, если таких узлов нет
Полеdata.departments[].nodeId Типnumber ОписаниеИдентификатор узла. Получить узел: GET /v1/humanresources/nodes/:id
Полеdata.departments[].name Типstring ОписаниеНазвание узла
Полеdata.departments[].role Типstring ОписаниеРоль сотрудника в узле в краткой форме: HEAD (руководитель), без префикса MEMBER_
Полеdata.departments[].subordinatesCount Типnumber ОписаниеЧисло подчинённых в этом узле

Пример ответа

JSON
{
  "success": true,
  "data": {
    "userId": 1,
    "departments": [
      {
        "nodeId": 9,
        "name": "Подразделение",
        "role": "HEAD",
        "subordinatesCount": 0
      },
      {
        "nodeId": 23,
        "name": "Отдел продаж",
        "role": "HEAD",
        "subordinatesCount": 1
      }
    ]
  }
}

Пример ответа при ошибке

400 — id не является положительным целым числом:

JSON
{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "id must be a positive integer"
  }
}

Ошибки

HTTP Код Описание
HTTP400 КодINVALID_PARAMS Описаниеid не является положительным целым числом (нечисловой, 0 или отрицательный)
HTTP403 КодSCOPE_DENIED ОписаниеКлючу не хватает скоупа humanresources
HTTP401 КодTOKEN_MISSING ОписаниеУ API-ключа не настроены токены Битрикс24

Полный список общих ошибок API — Ошибки.

Известные особенности

Имя поля в ответе отличается от параметра запроса. В пути запроса сотрудник задаётся сегментом :id, а в ответе тот же сотрудник возвращается под полем data.userId. На вход — id, на выход — userId.

В выдачу попадают только узлы, где сотрудник — руководитель. Массив data.departments содержит узлы, в которых у сотрудника роль HEAD. Если сотрудник не руководит ни одним узлом, массив приходит пустым. Узел остаётся в выдаче даже когда subordinatesCount равен 0 — то есть сотрудник назначен руководителем, но подчинённых в узле пока нет.

Смотрите также