В «API-ключах» создайте ключ и отметьте scope (сотрудники, зарплата, отделы, должности, учёт времени, отчёты; чтение или запись). Ключ виден один раз.
Создание ключа
В меню «API-ключи» нажмите «Новый API-ключ», задайте имя, по которому видно интеграцию (ERP, система учёта времени, BI), и отметьте scope. Доступны scope employees:read, employees:write, payroll:read, payroll:write, departments:read, departments:write, positions:read, positions:write, timeclock:read, timeclock:write и reports:read.
Ключ показывается один-единственный раз, при создании. Скопируйте его в хранилище секретов; если вы его потеряли, отзовите и создайте другой.
Один ключ, одна компания
Каждый ключ принадлежит одной компании и видит только её данные. Чтобы интегрировать несколько компаний одного аккаунта, создайте ключ в каждой из них. GET /companies возвращает компанию ключа, что помогает интегратору убедиться, куда он пишет.
Рекомендации
Используйте один ключ на интеграцию и только нужные ей scope: BI, читающему отчёты, достаточно reports:read и ничего больше. При утечке немедленно отзовите ключ; отзыв действует сразу. Каждое создание и отзыв записываются в журнал аудита, а вызовы с ключом логируются 90 дней.