Документація 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#/en/v1/

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

Початок роботи

Отримати API-ключ

У налаштуваннях вашої компанії на платформі Shifton згенеруйте API-ключ.
Авторизація здійснюється через заголовок:

Зробити перший запит

Наприклад, щоб отримати список співробітників:

Приклад відповіді:

Інтеграція API у Ваші Робочі Процеси

• Автоматично створюйте та змінюйте зміни

• Керуйте запитами на відпустки та лікарняні

• Експортуйте дані у платіжні системи

• Створюйте власні панелі керування та звіти

Основні можливості API

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

• Розклади – створювати, коригувати зміни, планувати роботу

• Відпустки та відсутності – керувати запитами на відпустку та лікарняний

• Звітування – експорт даних про час, заробітну плату та відвідування

Коди помилок

Shifton API використовує стандартні HTTP коди стану:

• 200 — Запит виконано успішно

• 201 — Об’єкт успішно створено

• 400 — Неправильні параметри

• 401 — Помилка авторизації (недійсний ключ API)

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

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

• 500 — Помилка сервера

Поради щодо використання

• Завжди використовуйте нову версію API для нових інтеграцій

• Використовуйте Postman або curl для тестування.

• Дотримуйтесь лімітів частоти запитів щоб уникнути блокування.

• Оновіть інтеграції, які досі покладаються на стару документацію.