Перейти к содержимому
GET /api/v1/applicant-labels/all - все теги апликантов организации: id, title и color.- Полученные
id используются в фильтре label_ids метода POST /api/v1/applicants/search.
- Требуется permission
recruiting_module.
GET /api/v1/candidates/{candidate_id}/feedbacks - все скоркарты кандидата с вопросами и ответами на них.- В каждом ответе возвращаются
question_title, question_type, answer_text (текст открытого ответа), comment (комментарий интервьюера к вопросу любого типа), answer_options (выбранные варианты шкалы или списка текстом) и answer_score.
- Незаполненные фидбеки тоже возвращаются: поля ответов пустые,
status отличается от completed.
- Требуется
feature ats_scorecards=true и доступ к кандидату.
GET /api/v1/candidates/{candidate_id}/feedbacks/overview - сводные показатели по скоркартам кандидата: requested_count, completed_count, avg_scale_score, max_scale_score, avg_score_mark и score_marks.- Подходит для дашбордов, где тексты ответов не нужны.
- Требуется
feature ats_scorecards=true и доступ к кандидату.
PUT /api/v1/applicants/{applicant_id}/labels - полностью заменяет набор тегов апликанта на переданный в теле label_ids; пустой список очищает теги.- Идентификаторы тегов, не принадлежащие организации, игнорируются.
- В ответе возвращается полный апликант, поэтому итоговый набор тегов виден сразу.
- Требуются permissions
recruiting_module=edit и manage_candidates=edit.
POST /api/v1/time-off/availability/search - даты, в которые сотрудники находятся в отпуске внутри периода.- Многодневные отпуска разворачиваются в отдельные дни и обрезаются по запрошенному периоду, поэтому пересекать интервалы на клиенте не нужно.
- Возвращаются только занятые даты; в каждом дне есть
time_off_category_id для склейки с GET /api/v1/time-off/categories и is_pending для несогласованных заявок.
- Свободные дни, выходные и праздники не возвращаются, неполная занятость не учитывается.
- Фильтры:
employee_ids, category_ids, department_ids, team_ids, division_ids, location_ids. Период ограничен 366 днями.
- Требуется permission
access_to_leave_timeline=edit.
- Новые необязательные
date_from и date_to оставляют только записи, чей период пересекается с запрошенным.
- Границы независимы: можно передать любую одну.
- Существующие интеграции не затронуты - без новых полей метод работает как прежде.
- Три значения
employee_fields теперь доходят до ответа. Раньше они принимались, но данные в тело ответа не попадали.
time_off - заполняет time_off, если сотрудник в отпуске сегодня: date_from, date_to, category и balance_requested. Дата не параметризуется, поэтому это ответ на вопрос «кто в отпуске прямо сейчас», а не баланс на прошедшую дату. У остальных - null.custom_tables - заполняет custom_tables: по элементу на таблицу с table_id и rows, в каждой строке id, date_effective_from, is_current и cells. У исторической таблицы приходит только актуальная строка.additional_compensations - заполняет additional_compensations выплатами текущего месяца (по UTC): id, date_effective_from, compensation_type, amount, amount_gross, amount_net, currency, description и comment. За всю историю - GET /api/v1/employees/{employee_id}/additional-compensations.- Все три блока добавочные: запрос без них возвращает ровно то же, что и раньше.
custom_tables требует фичу custom_fields, time_off - фичу time_off, а additional_compensations учитывает право на поле employee_additional_compensation по каждому сотруднику.
- Query-параметр
successor_employee_id теперь обязательный. Запрос без него возвращает 422.
- Преемник принимает сущности архивируемого сотрудника: подчинённых, цели, задачи и прочие назначения.
- Обновите интеграции до выкатки:
DELETE /api/v1/employees/{employee_id}?successor_employee_id={id}.
