External API: обновление статуса в расписании

Этот endpoint External API позволяет вашей HR- или WFM-системе устанавливать статус сотрудника в расписании UnSpot — например, отмечать удалённую работу или отсутствие (отпуск, больничный) на конкретный день.

Аутентификация

Создайте API-подключение типа User schedule в разделе Настройка > Интеграции > Настройки API и скопируйте токен. Передавайте его в каждом запросе:

Authorization: Bearer <token>

Authorization: Bearer <token>

Запросы без действительного токена возвращают 401. При превышении лимита запросов API возвращает 429 с заголовком Retry-After.

Обновление статуса — POST /api/external/v1/user-schedule

Если передаёте statusName или statusCode, все три поля — statusName, statusCode и statusType — должны быть указаны вместе.

Изменения, внесённые через этот эндпоинт, попадают в отчёт «История изменения рабочего графика» на странице «Отчеты»: в колонке «Место действия» у таких записей выводится значение External API. Состав колонок отчёта — в статье «Отчеты».

Пример: удалённая работа

curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  https://acme.unspot.ru/api/external/v1/user-schedule \
  -d '{
    "userEmail": "anna.ivanova@example.com",
    "date": "2026-07-10",
    "statusType": "REMOTE_WORK"
  }'

curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  https://acme.unspot.ru/api/external/v1/user-schedule \
  -d '{
    "userEmail": "anna.ivanova@example.com",
    "date": "2026-07-10",
    "statusType": "REMOTE_WORK"
  }'

Пример: именованное отсутствие

{
  "userEmail": "anna.ivanova@example.com",
  "date": "2026-07-13",
  "statusType": "NOT_WORKING",
  "statusName": "Отпуск",
  "statusCode": "ОТП"
}

{
  "userEmail": "anna.ivanova@example.com",
  "date": "2026-07-13",
  "statusType": "NOT_WORKING",
  "statusName": "Отпуск",
  "statusCode": "ОТП"
}

Пример: сброс статуса

{ "userEmail": "anna.ivanova@example.com", "date": "2026-07-10" }

{ "userEmail": "anna.ivanova@example.com", "date": "2026-07-10" }

Ответ: 200 с сообщением об успехе; изменение сразу видно в расписании пользователя.

Ошибки и лимиты

• 400 — Missing required field: userEmail / date; Invalid statusType value; правила совместности statusName/statusCode/statusType; User not found.
• 401 — неверный токен.
• 429 — чаще 1 запроса в секунду на токен. Для массовых обновлений добавляйте задержку.

Связанные статьи

• Управление рабочими статусами в расписании
• Статусы в расписании: простановка и влияние на брони
• Рабочий график: обзор раздела

Связанные статьи