Dokumentacija API-ja

Povezivanje i rad s Shifton API-jem

Shifton APIShifton API omogućava pristup svim ključnim značajkama platforme — od upravljanja rasporedom do integracija s vanjskim sustavima HR, plaće, i analitičkim sustavima.
Korištenjem API-ja možete automatizirati procese i povezati Shifton s internim uslugama vaše tvrtke.

API dokumentacija

Podržavamo dvije verzije naše dokumentacije:

• 📄 Stara dokumentacija — prethodna verzija API reference (još uvijek podržana za postojeće integracije):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Nova dokumentacija — trenutna verzija API-ja s ažuriranom strukturom i najnovijim metodama:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Početak korištenja

Nabavite API ključ

U postavkama vaše tvrtke na Shifton platformi generirajte API ključ.
Autorizacija se vrši putem zaglavlja:

Izvršite svoj prvi zahtjev

Na primjer, za dohvaćanje popisa zaposlenika:

Primjer odgovora:

Integrirajte API u svoje tokove rada

• Automatski kreirajte i mijenjajte smjene

• Upravljajte zahtjevima za godišnje odmore i bolovanja

• Izvozite podatke u sustave za plaće

• Izradite prilagođene nadzorne ploče i izvješća

Osnovne mogućnosti API-ja

• Zaposlenici – dodajte, uredite i upravljajte ulogama

• Rasporedi – kreirajte, prilagodite smjene, planirajte rad

• Slobodno vrijeme i izostanci – upravljajte zahtjevima za godišnji odmor i bolovanje

• Izvještavanje – izvezite podatke o vremenu, platama i prisutnosti

Kodovi grešaka

Shifton API koristi standardne HTTP statusne kodove:

• 200 — Uspješan zahtjev

• 201 — Objekt uspješno kreiran

• 400 — Nevažeći parametri

• 401 — Greška autorizacije (nevažeći API ključ)

• 403 — Pristup odbijen

• 404 — Resurs nije pronađen

• 500 — Greška na serveru

Savjeti za uporabu

• Uvijek koristite novu verziju API-ja za nove integracije

• Koristite Postman ili curl za testiranje

• Poštujte ograničenja brzine kako biste izbjegli blokiranje

• Ažurirajte integracije koje se još uvijek oslanjaju na staru dokumentaciju