Документация по API

Подключение и работа с API Shifton

API Shifton предоставляет доступ ко всем ключевым функциям платформы — от управления расписанием до интеграции с внешними HR, системами начисления зарплаты и аналитическими системами.
С помощью API вы можете автоматизировать процессы и подключать Shifton к внутренним сервисам вашей компании.

Документация по API

Мы поддерживаем две версии нашей документации:

• 📄 Старая документация — предыдущая версия справочника API (все еще поддерживается для существующих интеграций):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/ru/v1/

• 🚀 Новая документация — текущая версия API с обновленной структурой и последними методами:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Начало работы

Получение API-ключа

В настройках вашей компании на платформе Shifton создайте API-ключ.
Авторизация выполняется через заголовок:

Сделайте первый запрос

Например, чтобы получить список сотрудников:

Пример ответа:

Интеграция API в ваши рабочие процессы

• Автоматически создавать и изменять смены

• Управлять запросами на отпуск и больничные

• Экспортировать данные в системы начисления зарплаты

• Создавать индивидуальные панели и отчеты

Основные возможности API

• Сотрудники – добавление, редактирование и управление ролями

• Расписания – создание, корректировка смен, планирование работы

• Выходные и отсутствие – управление заявками на отпуск и больничный

• Отчеты – экспорт данных о времени, заработной плате и посещаемости

Коды ошибок

API Shifton использует стандартные коды состояния HTTP:

• 200 — Запрос успешен

• 201 — Объект успешно создан

• 400 — Неверные параметры

• 401 — Ошибка авторизации (неверный ключ API)

• 403 — Доступ запрещен

• 404 — Ресурс не найден

• 500 — Ошибка сервера

Советы по использованию

• Всегда используйте новую версию API для новых интеграций

• Используйте Postman или curl для тестирования

• Соблюдайте ограничения по скорости чтобы избежать блокировки

• Обновите интеграции, которые по-прежнему зависят от старой документации