Главная / Документация / APIAPI: ресурсы и центры компетенцийМаршруты загрузки сотрудников, заявок на ресурсы, центров компетенций, отсутствий (в том числе своих) и производственного календаря volrix.pm.Обновлено 16.10.2026Группа отвечает на вопрос «кто свободен»: загрузка сотрудника по проектам, сводки по центрам компетенций и предприятию, заявки проекта на выделение ресурсов, отсутствия (отпуск, больничный) и производственный календарь с рабочими днями и часовой нормой.**Что принимает API-ключ.** Загрузка сотрудника (project_team:read), сводка по предприятию (reports:read), заявки на ресурсы (project_team:...), центры компетенций, список отсутствий и их изменение (employees:...) и календарь. Отчет по загрузке, сводки по центрам и личные отсутствия (/me/absences: просмотр, добавление и удаление своих периодов) работают только в сессии.Базовый адрес, формат ответов и коды ошибок описаны в статье API: адрес, первый запрос и ответы, выпуск ключа и вход под пользователем - в статье API: вход, токен и API-ключи. В примерах ключ лежит в переменной окружения VOLRIX_API_KEY, токен пользователя - в VOLRIX_TOKEN.Типовой сценарий: проверить загрузку перед назначением

Найдите сотрудника GET /api/v1/people?search=... (employees:read) - нужен person_id.

Посмотрите загрузку GET /api/v1/resource-workload/person/{person_id}?start=...&end=... (project_team:read) - загрузка по периодам участия в проектах.

Примерьте назначение Добавьте extra_percent, extra_start и extra_end: сервер покажет загрузку с учетом нового назначения, ничего не сохраняя. При правке участника исключите его текущую строку параметром exclude_member_id.

Учтите отсутствия GET /api/v1/absences?date_from=...&date_to=... (employees:read) - отсутствия всех сотрудников за период; по одному сотруднику - GET /api/v1/people/{person_id}/absences (сессия). Сотрудник от своего имени добавляет период через POST /api/v1/me/absences (сессия).

Примеры запросовЗагрузка сотрудника на квартал с предпросмотром назначения на 50% (скоуп project_team:read):curl --fail-with-body -sS \ -H "X-Api-Key: $VOLRIX_API_KEY" \ "https://ваш-адрес/api/v1/resource-workload/person/{person_id}?start=2026-10-01&end=2026-12-31&extra_percent=50&extra_start=2026-10-01&extra_end=2026-11-30"Норма рабочего дня (скоуп working_calendar:read) и отпуск сотрудника (скоуп employees:update):curl --fail-with-body -sS \ -H "X-Api-Key: $VOLRIX_API_KEY" \ "https://ваш-адрес/api/v1/working-calendar/workday-hours" curl --fail-with-body -sS -X POST \ -H "X-Api-Key: $VOLRIX_API_KEY" \ -H "Content-Type: application/json" \ -d '{"kind": "vacation", "start_date": "2026-11-02", "end_date": "2026-11-15"}' \ "https://ваш-адрес/api/v1/people/{person_id}/absences"МаршрутыКак читать колонку «Доступ»: **скоуп вида users:read** - маршрут принимает API-ключ, если в ключе есть этот скоуп, а у сотрудника, выпустившего ключ, есть такое же право в роли (users.read). Если скоупов несколько через «+», нужны все. **Только сессия** - нужен заголовок Authorization: Bearer, API-ключ получит 403. **Без авторизации** - заголовки не нужны. Доступ к конкретному объекту (участие в проекте, права на папку Диска) сервер проверяет дополнительно. Пути в таблицах указаны полностью, от корня сервера.Загрузка ресурсов

Метод и путь

Параметры и тело

Доступ (скоуп ключа)

Успешный ответ

GET /api/v1/resource-workload/person/{person_id}

person_id [path обяз.]: string (uuid); exclude_member_id [query]: string (uuid) / null; extra_percent [query]: number / null; extra_start [query]: string (date) / null; extra_end [query]: string (date) / null; start [query]: string (date) / null; end [query]: string (date) / null

project_team:read

200: object

GET /api/v1/resource-workload/report

year [query обяз.]: integer; center_id [query]: string (uuid) / null

Только сессия

200: object

GET /api/v1/resource-workload/enterprise-summary

year [query обяз.]: integer

reports:read

200: object

GET /api/v1/resource-workload/centers

Нет

Только сессия

200: object

GET /api/v1/resource-workload/center/{center_id}/overview

center_id [path обяз.]: string (uuid); year [query обяз.]: integer

Только сессия

200: object

Заявки на выделение ресурсов

Метод и путь

Параметры и тело

Доступ (скоуп ключа)

Успешный ответ

POST /api/v1/projects/{project_id}/resource-allocation/submit

project_id [path обяз.]: string (uuid)

project_team:manage

200: object

GET /api/v1/projects/{project_id}/resource-allocation

project_id [path обяз.]: string (uuid)

project_team:read

200: object

Центры компетенций

Метод и путь

Параметры и тело

Доступ (скоуп ключа)

Успешный ответ

GET /api/v1/competency-centers

Нет

competency_centers:read

200: array[CompetencyCenterRead]

POST /api/v1/competency-centers

Нет | Тело: application/json: CompetencyCenterCreate

competency_centers:create

201: CompetencyCenterRead

PUT /api/v1/competency-centers/{center_id}

center_id [path обяз.]: string (uuid) | Тело: application/json: CompetencyCenterUpdate

competency_centers:update

200: CompetencyCenterRead

DELETE /api/v1/competency-centers/{center_id}

center_id [path обяз.]: string (uuid)

competency_centers:delete

204

Отсутствия

Метод и путь

Параметры и тело

Доступ (скоуп ключа)

Успешный ответ

GET /api/v1/me/absences

start [query]: string (date) / null; end [query]: string (date) / null

Только сессия

200: array[AbsenceRead]

POST /api/v1/me/absences

Тело: application/json: AbsenceCreate

Только сессия

201: AbsenceRead

DELETE /api/v1/me/absences/{absence_id}

absence_id [path обяз.]: string (uuid)

Только сессия

204

GET /api/v1/absences

date_from [query обяз.]: string (date); date_to [query обяз.]: string (date)

employees:read

200: array[AbsenceCalendarItem]

GET /api/v1/people/{person_id}/absences

person_id [path обяз.]: string (uuid); start [query]: string (date) / null; end [query]: string (date) / null

Только сессия

200: array[AbsenceRead]

POST /api/v1/people/{person_id}/absences

person_id [path обяз.]: string (uuid) | Тело: application/json: AbsenceCreate

employees:update

201: AbsenceRead

PUT /api/v1/absences/{absence_id}

absence_id [path обяз.]: string (uuid) | Тело: application/json: AbsenceUpdate

employees:update

200: AbsenceRead

DELETE /api/v1/absences/{absence_id}

absence_id [path обяз.]: string (uuid)

employees:update

204

**Свои отсутствия.** POST /me/absences и DELETE /me/absences/{absence_id} доступны любому сотруднику без права employees.update: период записывается на самого вызывающего, поле person_id в теле не нужно. Удалить можно только период, внесенный самим сотрудником. Если период завел руководитель или кадровая служба (через POST /people/{person_id}/absences), ответ будет 403 «Этот период внес руководитель или кадровая служба - удалить его может только он»; для такого периода используйте DELETE /absences/{absence_id} с правом employees.update. Чужой или несуществующий период дает 404. Неверные данные (дата окончания раньше даты начала, незнакомый тип) вернут 400 с пояснением в detail.**Поле created_by_id.** Во всех ответах с типом AbsenceRead (GET /me/absences, GET /people/{person_id}/absences, POST и PUT) есть created_by_id - идентификатор сотрудника, который внес период. Он совпадает с person_id, если сотрудник отметил отсутствие сам, и отличается, если период внес другой человек. По этому полю интерфейс решает, показывать ли кнопку удаления в личной вкладке «Мои отсутствия». Допустимые значения kind: vacation (отпуск), sick (больничный), unpaid (без содержания), other (прочее).Производственный календарь

Метод и путь

Параметры и тело

Доступ (скоуп ключа)

Успешный ответ

GET /api/v1/working-calendar

from [query обяз.]: string (date); to [query обяз.]: string (date)

Только сессия

200: array[CalendarDay]

GET /api/v1/working-calendar/admin/year/{year}

year [path обяз.]: integer

working_calendar:update

200: array[CalendarDayAdmin]

PUT /api/v1/working-calendar/admin/day

Нет | Тело: application/json: DayToggleRequest

working_calendar:update

200: CalendarDayAdmin

DELETE /api/v1/working-calendar/admin/day/{day_date}

day_date [path обяз.]: string (date)

working_calendar:update

200: object

GET /api/v1/working-calendar/admin/settings

Нет

working_calendar:update

200: CalendarSettings

PUT /api/v1/working-calendar/admin/settings

Нет | Тело: application/json: CalendarSettings

working_calendar:update

200: CalendarSettings

POST /api/v1/working-calendar/admin/load-year

Нет | Тело: application/json: LoadYearRequest

working_calendar:update

200: object

GET /api/v1/working-calendar/workday-hours

Нет

working_calendar:read

200: WorkdayHours-Output

PUT /api/v1/working-calendar/workday-hours

Нет | Тело: application/json: WorkdayHours-Input

working_calendar:update

200: WorkdayHours-Output

Тела запросовПоля JSON и форм multipart из схемы сервера. «Да» - поле обязательно. Ссылка на другую схему (например, array[QCApproverInput]) означает вложенный объект с теми же полями.CompetencyCenterCreate: POST /competency-centers

Поле

Обязательно

Тип / значения

Ограничения

name

Да

string

minLength=1; maxLength=255

code

Нет

string / null

head_id

Да

string (uuid)

description

Нет

string / null

is_active

Нет

boolean

default=true

CompetencyCenterUpdate: PUT /competency-centers/{center_id}

Поле

Обязательно

Тип / значения

Ограничения

name

Нет

string / null

code

Нет

string / null

head_id

Нет

string (uuid) / null

description

Нет

string / null

is_active

Нет

boolean / null

AbsenceCreate: POST /people/{person_id}/absences и POST /me/absences

Поле

Обязательно

Тип / значения

Ограничения

kind

Нет

string

default="vacation"

start_date

Да

string (date)

end_date

Да

string (date)

comment

Нет

string / null

AbsenceUpdate: PUT /absences/{absence_id}

Поле

Обязательно

Тип / значения

Ограничения

kind

Нет

string / null

start_date

Нет

string (date) / null

end_date

Нет

string (date) / null

comment

Нет

string / null

DayToggleRequest: PUT /working-calendar/admin/day

Поле

Обязательно

Тип / значения

Ограничения

date

Да

string (date)

is_working

Да

boolean

description

Нет

string / null

CalendarSettings: PUT /working-calendar/admin/settings

Поле

Обязательно

Тип / значения

Ограничения

autoload_enabled

Да

boolean

country

Да

string

LoadYearRequest: POST /working-calendar/admin/load-year

Поле

Обязательно

Тип / значения

Ограничения

year

Да

integer

WorkdayHours-Input: PUT /working-calendar/workday-hours

Поле

Обязательно

Тип / значения

Ограничения

hours

Да

number / string

Если не получается

Что видно

Причина и что сделать

403 «API-ключи не поддерживаются на этом эндпоинте»

У маршрута в таблице указано «Только сессия». Выполните его с заголовком Authorization: Bearer от имени сотрудника, см. вход под пользователем.

403 на /working-calendar/admin/... со скоупом working_calendar:read

Административные маршруты календаря требуют working_calendar:update, чтение нормы дня - working_calendar:read.

403 «API-ключ не имеет права (...)»

В ключе нет скоупа из колонки «Доступ». Скоупы после создания не меняются: выпустите новый ключ с нужным скоупом в «Администрирование» → «Настройки продукта» → «Интеграции» и отзовите старый.

403 «Недостаточно прав (...)»

У пользователя или у сотрудника, выпустившего ключ, нет названного права в роли (с 0.110.6 для ключа проверяются и скоуп, и право владельца). Добавьте право в роль: «Администрирование» → «Доступ» → «Роли и права».

423 на POST, PUT, PATCH или DELETE, чтение работает

Нет действующей лицензии (в ответе license_status: expired, invalid, missing или mismatch). Изменения заблокированы до загрузки файла лицензии, см. Лицензия.

Ресурсы

Центры компетенций

Производственный календарь

Загрузка и доступность командыРуководитель и составРабочие дни и часовая норма

Интеграции и REST API

Функциональная карта