Заголовки запроса
API-токен сервисного пользователя в формате
Bearer YOUR_TOKEN. Токен выпускает владелец школы в кабинете:
Управление → Школа → Для разработчиков → API-ключи — подробнее в разделе «Аутентификация».Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице API-ключи в
карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.
Числовой ID школы, берётся там же, где
Seller-Id. Значение должно совпадать со школой продавца — иначе
вернётся ошибка 400 с cause: "ForbiddenSchoolMismatch".Грейды — это уровни карьерной лестницы школы (например, Junior → Middle → Senior). Шкала грейдов одна на все
должности школы. Грейд присваивается сотруднику при найме, повышении и переводе (см.
занятость) и используется для расчёта готовности к следующему грейду.
Требования к правам доступа
Чтение (
list) требует права «Просмотр персонала» (StaffView). Создание, обновление и удаление требуют права «Управление персоналом» (StaffManage).
Во всех случаях необходима аутентификация по токену и принадлежность школы к сегменту Corporate.Как устроена шкала
Порядок. Поле
order — место грейда на лестнице: чем больше order, тем выше грейд. Новый грейд создаётся
на вершине шкалы. Порядок грейдов меняется в интерфейсе (Школа → Структура → Грейды, перетаскиванием строки);
через REST API порядок не меняется. Список грейдов всегда возвращается от младшего к старшему.Включение грейдов. Грейды включаются в разделе «Грейды» в интерфейсе. Шкалу можно настроить заранее — через
API или в интерфейсе, — но присвоить грейд сотруднику (
gradeId в hire, toGradeId в promote и transfer)
можно только после включения: иначе вернётся ошибка StaffGradesDisabled.Грейды должности. Должность может ограничить список подходящих ей грейдов — параметр
gradeIds при
создании и обновлении должности. Если ограничение не задано, должности
подходят любые грейды школы. Сотруднику можно присвоить только грейд своей должности, иначе вернётся
StaffGradeNotForPosition.Условия перехода. Условия перехода на грейд (курсы, которые нужно пройти сотруднику на конкретной должности)
настраиваются в интерфейсе. По ним считается готовность к следующему грейду — сотрудников, выполнивших все условия,
можно получить фильтром
readyForPromotion в списке занятостей.Название грейда уникально в рамках школы без учёта регистра («Senior» и «senior» — одно и то же название).
Попытка создать или переименовать грейд в уже существующее название в этой же школе вернёт ошибку
StaffGradeNameIsNotUniq.Поле
extId — внешний идентификатор грейда из системы клиента (CRM/1C, например GUID). Уникален в рамках
школы среди неудалённых записей. От 1 до 50 символов, не может содержать / и пробельные символы — значение
используется в путях ext/{extId}.Список грейдов
StaffView).
Эндпоинт возвращает пагинированный список грейдов, упорядоченный по
order — от младшего грейда к старшему.
Параметры пагинации и фильтрации передаются как query-параметры.Параметры
Фильтр по списку внешних идентификаторов (
extId). До 250 значений, каждое — максимум 50 символов.Грейды, подходящие должности: её собственный список грейдов, а если у должности нет ограничения — все грейды
школы.
Поиск по названию грейда. Максимум 50 символов. Поиск нечёткий (находит и частичные совпадения), поэтому для
поиска конкретного грейда по имени сравнивайте
name найденных записей со своим значением без учёта регистра,
а надёжнее — ищите по extIds.Ответ
Пагинированный объект:
items (массив грейдов), page, count, pages, isFirst, isLast, next, prev.Создание грейда
StaffManage).
Новый грейд встаёт на вершину шкалы — получает наибольший
order в школе. Чтобы поставить его на другое место,
измените порядок в интерфейсе.Параметры запроса
Название грейда. От 1 до 100 символов. Пробелы в начале и конце обрезаются автоматически. Должно быть
уникальным в рамках школы.
Описание грейда — чем он отличается от соседних. До 500 символов. Пробелы в начале и конце обрезаются
автоматически.
Внешний идентификатор грейда из системы клиента (CRM/1C). От 1 до 50 символов, не может содержать
/ и
пробельные символы. Должен быть уникальным в рамках школы среди неудалённых записей.Обновление грейда
StaffManage).
Параметры
Новое название грейда. От 1 до 100 символов. Пробелы в начале и конце обрезаются автоматически. Должно быть
уникальным в рамках школы.
Внешний идентификатор грейда из системы клиента (CRM/1C). От 1 до 50 символов, не может содержать
/ и
пробельные символы. Должен быть уникальным в рамках школы среди неудалённых записей.Обновление грейда по extId
StaffManage).
Эндпоинт-аналог обновления по ID: грейд находится по внешнему идентификатору
extId в рамках школы.
Значение extId в пути должно быть URL-encoded.Параметры
Внешний идентификатор (
extId) обновляемого грейда в рамках школы. Должен быть URL-encoded.Новое название грейда. От 1 до 100 символов. Пробелы в начале и конце обрезаются автоматически. Должно быть
уникальным в рамках школы.
Новый внешний идентификатор грейда. От 1 до 50 символов, не может содержать
/ и пробельные символы.
Должен быть уникальным в рамках школы среди неудалённых записей.Удаление грейда
StaffManage).
При удалении грейд снимается со всех должностей, которым он был назначен, а его условия перехода удаляются.
Готовность сотрудников к следующему грейду пересчитывается.
Параметры
Ответ
Удаление грейда по extId
StaffManage).
Эндпоинт-аналог удаления по ID: грейд находится по внешнему идентификатору
extId в рамках школы.
Значение extId в пути должно быть URL-encoded.Параметры
Внешний идентификатор (
extId) удаляемого грейда в рамках школы. Должен быть URL-encoded.Ответ
Обновлено: 2026-10-16 13:24 UTC