API dokumentācija

Savienošanās un darbs ar Shifton API

Shifton API sniedz piekļuvi visām platformas galvenajām funkcijām — no grafiku pārvaldības līdz integrācijām ar ārējām HRiespējām, , algas sarakstu un analītikas sistēmām.
Izmantojot API, jūs varat automatizēt procesus un savienot Shifton ar jūsu uzņēmuma iekšējiem pakalpojumiem.


API Dokumentācija

Mēs atbalstām divas mūsu dokumentācijas versijas:


Darba uzsākšana

Iegūt API atslēgu

Jūsu uzņēmuma iestatījumos Shifton platformā izveidojiet API atslēgu.
Autorizācija tiek veikta caur galveni:

Authorization: Bearer {your_api_key}

Veiciet savu pirmo pieprasījumu

Piemēram, lai iegūtu darbinieku sarakstu:

GET /api/v1/employees
Host: api2.shifton.com
Authorization: Bearer {your_api_key}

Piemēra atbilde:

{
"data": [
{
"id": 101,
"name": "Alice Johnson",
"position": "HR Manager"
},
{
"id": 102,
"name": "Bob Smith",
"position": "Cashier"
}
]
}

Integrējiet API savos darbplūsmas procesos

  • Automātiski izveidojiet un modificējiet maiņas

  • Pārvaldiet atvaļinājuma un slimības lapas pieprasījumus

  • Eksportējiet datus uz algas sistēmām

  • Veidojiet pielāgotus informācijas panelus un atskaites


Pamata API iespējas

  • Darbinieki – pievienot, rediģēt un pārvaldīt lomas

  • Grafiki – veidot, pielāgot maiņas, plānot darbu

  • Atvaļinājumi un prombūtnes – pārvaldīt atvaļinājumu un slimības atvaļinājumu pieprasījumus

  • Atskaites – eksportēt laiku, algu un apmeklējumu datus


Kļūdu kodi

Shifton API izmanto standarta HTTP statusa kodus:

  • 200 — Veiksmīgs pieprasījums

  • 201 — Objekts veiksmīgi izveidots

  • 400 — Nederīgi parametri

  • 401 — Autorizācijas kļūda (nederīga API atslēga)

  • 403 — Piekļuve liegta

  • 404 — Resurss nav atrasts

  • 500 — Servera kļūda


Lietošanas padomi

  • Vienmēr izmantojiet jaunāko API versiju jauniem integrācijām

  • Izmanto Postman vai curl testēšanai

  • Ievēro pieprasījumuierobežojumus lai izvairītos no bloķēšanas

  • Atjaunini integrācijas, kas joprojām paļaujas uz veco dokumentāciju


Dalīties ar šo ziņu