Документација за API

Поврзување и работа со Shifton API

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 за тестирање

• Почитувајте го лимитот на брзина за да избегнете блокирање

• Ажурирајте ги интеграциите кои сè уште се потпираат на старата документација