метод REST scope: humanresources.hcmlink

humanresources.hcmlink.employee.list

Получить список сопоставленных сотрудников HCM Link

Кто может выполнять: администратор

Описание

Метод humanresources.hcmlink.employee.list возвращает список сопоставленных сотрудников системы кадрового учета и Битрикс24.

Метод работает только в контексте авторизации приложения.

Параметры

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

Код компании в системе кадрового учета.

Получить код можно методом humanresources.hcmlink.company.list

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

Количество записей на странице.

Допустимые значения — от 1 до 1000. По умолчанию 100

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

Смещение для постраничной навигации.

По умолчанию 0

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

Дата изменения в формате ISO 8601. Если передана, метод вернет записи, измененные после этой даты

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"company":"hr-company-001","limit":50,"offset":0,"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/humanresources.hcmlink.employee.list

Ответ

HTTP-статус: 200

{
    "result": [
        {
            "id": 7,
            "company": "hr-company-001",
            "person": "person-001",
            "employees": [
                {
                    "id": 21,
                    "employee": "employee-001",
                    "data": {
                        "position": "Менеджер"
                    },
                    "createdAt": "2026-08-06T19:51:02+03:00"
                }
            ],
            "userId": 25,
            "title": "Иван Петров",
            "createdAt": "2026-08-06T19:51:02+03:00",
            "updatedAt": "2026-08-06T19:51:02+03:00"
        }
    ],
    "time": {
        "start": 1739860000.123,
        "finish": 1739860000.456,
        "duration": 0.333,
        "processing": 0.111,
        "date_start": "2026-08-06T19:51:02+03:00",
        "date_finish": "2026-08-06T19:51:02+03:00"
    }
}

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

result array

Список сопоставленных сотрудников (подробное описание)

time time

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

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

HTTP-статус: 200

{
    "error": 510,
    "error_description": "Operation failed"
}
Код Описание Значение
510 Operation failed Компания не найдена или не передан параметр company
ACCESS_DENIED Access denied! Access denied. Пользователь не является администратором
WRONG_AUTH_TYPE Application context required Метод вызван не в контексте приложения

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

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