Перейти к основному содержимому

Получить страницу сотрудников узла оргструктуры

GET 
/api/v1/clients/:clientId/orgStructures/:id/elements/:elementId/employees

Описание метода​

Возвращает страницу подчинённых сотрудников узла оргструктуры с сортировкой по ФИО. Руководители узла (HEAD_MANAGER) в выдачу не включаются — они доступны в карточке узла через headEmployees. Для Юридической оргструктуры elementId трактуется как id отдела (client_department).

Query-параметр ids задаёт точечную выборку без пагинации: непустой список означает «вернуть ровно сотрудников узла с этими IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях.» — limit/offset при этом игнорируются. IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях., не входящие в узел, молча пропускаются; руководитель узла не отдаётся ни в одном из режимов. Порядок передачи ids не влияет на порядок ответа — выдача всегда отсортирована по ФИО.

Для Юридической оргструктуры поддерживается синтетический узел «Сотрудники без отдела» (549d1eb3-16b4-4cdd-95f2-66b3671e69c7) — возвращает страницу активных сотрудников клиента без отдела. Узел существует виртуально всегда, запрос для него никогда не возвращает ошибку отсутствия узла.

Поле верхнего уровня ответа — employees. Признак конца списка на фронте — то, что вернулось меньше элементов, чем запрошено в limit, либо пустой массив.

Валидации запроса​

  • IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID; клиент существует, не удалён, к нему относится пользователь, выполняющий операцию.

  • IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. оргструктуры соответствует формату UUID; оргструктура существует и принадлежит клиенту.

  • Видимость оргструктуры: пользователь с правом ORG_STRUCTURES_UPDATE видит любую оргструктуру; обычный сотрудник — только опубликованную с доступом PUBLIC либо RESTRICTED, в которой он состоит. Для Юридической проверка пропускается.

  • IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. узла соответствует формату UUID; узел существует и принадлежит указанной оргструктуре.

  • limit не отрицательный; превышение максимального значения пагинации недопустимо. Игнорируется при непустом ids.

  • offset не отрицательный. Игнорируется при непустом ids.

  • ids, если задан, — список корректных UUID без null-элементов; размер после дедупликации не превышает максимальное значение пагинации.

  • Функционал оргструктур включён в настройках клиента.

Request​

Responses​

Успешная операция.