API dokumentacija

Jungimasis ir darbas su Shifton API

Shifton API suteikia prieigą prie visų pagrindinių platformos funkcijų – nuo tvarkaraščių valdymo iki integracijų su išorinėmis personalo , pajamų skaičiavimo ir analitikos sistemomis.
Naudojant API, galite automatizuoti procesus ir sujungti Shifton su jūsų įmonės vidinėmis paslaugomis.

API Dokumentacija

Mes palaikome dvi dokumentacijos versijas:

• 📄 Sena dokumentacija – ankstesnė API nuorodų versija (vis dar palaikoma esamoms integracijoms):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Nauja dokumentacija – dabartinė API versija su atnaujinta struktūra ir naujausiais metodais:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Pradžia

Įsigykite API raktą

Savo įmonės nustatymuose Shifton platformoje sugeneruokite API raktą.
Autorizacija vykdoma per antraštę:

Pateikite pirmą užklausą

Pavyzdžiui, norėdami gauti darbuotojų sąrašą:

Pavyzdinis atsakymas:

Integruokite API į savo darbo procesus

• Automatiškai kurkite ir redaguokite pamainas

• Tvarkykite atostogų ir ligos lapelių prašymus

• Eksportuokite duomenis į pajamų skaičiavimo sistemas

• Kurkite individualius prietaisų skydelius ir ataskaitas

Pagrindinės API galimybės

• Darbuotojai – pridėti, redaguoti ir tvarkyti vaidmenis

• Tvarkaraščiai – kurti, keisti pamainas, planuoti darbą

• Atostogos ir nebuvimas darbe – tvarkyti atostogų ir ligos lapelių prašymus

• Ataskaitos – eksportuoti laiką, atlyginimą ir lankomumo duomenis

Klaidos kodai

Shifton API naudoja standartinius HTTP būsenos kodus:

• 200 — Sėkminga užklausa

• 201 — Objektas sėkmingai sukurtas

• 400 — Neteisingi parametrai

• 401 — Autorizacijos klaida (neteisingas API raktas)

• 403 — Prieiga draudžiama

• 404 — Išteklius nerastas

• 500 — Serverio klaida

Naudojimo patarimai

• Visada naudokite naują API versiją naujoms integracijoms

• Naudokite Postman arba curl bandymams

• Gerbkite normų ribas kad išvengtumėte blokavimo

• Atnaujinkite integracijas, kurios vis dar remiasi sena dokumentacija