Dokumentacija API

Povezovanje in delo z API-jem Shifton

API Shifton vam omogoča dostop do vseh ključnih funkcij platforme — od upravljanja urnikov do integracij z zunanjimi HR, plačilnimi sistemi, in analitičnimi sistemi.
Z uporabo API-ja lahko avtomatizirate procese in povežete Shifton z notranjimi storitvami vašega podjetja.

Dokumentacija API-ja

Podpiramo dve različici naše dokumentacije:

• 📄 Stara dokumentacija — prejšnja različica referenc API (še vedno podprta za obstoječe integracije):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Nova dokumentacija — trenutna različica API-ja s posodobljeno strukturo in najnovejšimi metodami:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Začetek

Pridobite API ključ

V nastavitvah vašega podjetja na platformi Shifton ustvarite API ključ.
Avtorizacija se izvede preko zaglavja:

Opravite svojo prvo zahtevo

Na primer, za pridobitev seznama zaposlenih:

Primer odgovora:

Integrirajte API v svoje delovne tokove

• Avtomatsko ustvarjajte in spreminjajte izmene

• Upravljajte z zahtevki za dopust in bolniško odsotnost

• Izvoz podatkov v sisteme za izplačilo plač

• Izdelajte prilagojene nadzorne plošče in poročila

Temeljne zmožnosti API-ja

• Zaposleni – dodajanje, urejanje in upravljanje vlog

• Urniki – ustvarjanje, prilagajanje izmen, načrtovanje dela

• Prosti čas in odsotnosti – upravljanje zahtevkov za dopust in bolniško odsotnost

• Poročanje – izvoz podatkov o času, plačah in prisotnosti

Kode napak

Shifton API uporablja standardne HTTP statusne kode:

• 200 — Uspešna zahteva

• 201 — Objekt uspešno ustvarjen

• 400 — Neveljavni parametri

• 401 — Napaka pri avtorizaciji (neveljaven API ključ)

• 403 — Dostop zavrnjen

• 404 — Virov ni mogoče najti

• 500 — Napaka na strežniku

Nasveti za uporabo

• Vedno uporabljajte novo različico API-ja za nove integracije

• Uporabite Postman ali curl za testiranje

• Spoštujte omejitve hitrosti da preprečite blokado

• Posodobite integracije, ki še vedno temeljijo na stari dokumentaciji