Документация за 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 за тестване

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

• Актуализирайте интеграциите, които все още разчитат на старата документация