API құжаттамасы

Shifton API-мен байланысу және жұмыс істеу

Shifton API сізге платформаның барлық негізгі функцияларына қол жеткізу мүмкіндігін береді — кестені басқарудан бастап сыртқы жүйелермен интеграцияға дейін HR, жалақы және аналитика жүйелерімен.
API-ді пайдалану арқылы сіз процестерді автоматтандырып, Shifton-ды компанияңыздың ішкі қызметтеріне қосуға болады.

API құжаттамасы

Біз құжаттамамыздың екі нұсқасын қолдаймыз:

• 📄 Ескі құжаттама — API анықтамалығының алдыңғы нұсқасы (бар интеграциялар үшін әлі де қолдау көрсетіледі):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/kk/v1/

• 🚀 Жаңа құжаттама — API-дің қазіргі нұсқасы жаңартылған құрылыммен және соңғы әдістермен:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Бастапқы қадамдар

API кілтін алыңыз

Shifton платформасындағы компанияңыздың баптауларында API кілтін.
жасап алыңыз. Авторизацияны тақырып арқылы орындаңыз:

Бірінші сұрауыңызды орындаңыз

Мысалы, қызметкерлер тізімін алу үшін:

Мысал жауап:

API-ды жұмыс процестеріңізге қосыңыз

• Ауысымдарды автоматты түрде жасап, өзгертіңіз

• Демалыс және ауруханадық өтініштерін басқарыңыз

• Деректерді жалақы жүйелеріне экспорттаңыз

• Арнайы бақылау тақталарын және есептерді жасаңыз

Core API мүмкіндіктері

• Қызметкерлер – рөлдерді қосу, өзгерту және басқару

• Кестелер – ауысымдарды құру, түзету, жұмыс жоспарлау

• Уақытша босату және жоқ болу – демалыс және ауруханаға кету өтініштерін басқару

• Есеп беру жүйесі – уақытты, жалақы және қатысу деректерін экспорттау

Қателік кодтары

Shifton API стандартты пайдаланадыHTTP күй кодтары:

• 200 — Сұраныс сәтті орындалды

• 201 — Объект сәтті құрылды

• 400 — Қате параметрлер

• 401 — Авторизация қатесі (API кілті жарамсыз)

• 403 — Кіруге тыйым салынған

• 404 — Ресурс табылмады

• 500 — Сервер қатесі

Қолдану кеңестері

• Әрқашан жаңа интеграция үшін API жаңа нұсқасын қолданыңыз

• Пайдаланыңыз Postman немесе curl тексеру үшін

• Шектеу жылдамдық лимиттері болдырмау үшін бұғатталудан өту

• Ескі құжаттамаға әлі де тәуелді интеграцияларды жаңартыңыз